draft-article

Create a new blog post draft via the Bhart Blog Automation API when the user provides a subject and thoughts for the article. Use for requests to draft, outline, or publish a new post (not edits) and when you need to format the draft in the house writing style and submit it as a draft.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/draft-article-brucehart-bhart-org

SKILL.md

Draft Article

Overview

Create a new post draft from a subject and raw thoughts, following the house writing style and the Blog Automation API workflow.

Load references/agents.md before generating or submitting drafts.

Workflow

1) Gather required inputs

Ask for anything missing: title, summary, tags, author_name, author_email.
Confirm any optional items the user cares about: slug, hero_image_url, hero_image_alt, featured, seo_title, seo_description.
If tags are unclear, offer to fetch tag suggestions with GET /tags.

2) Draft the article

Use the writing style in references/agents.md.
Open with a hook and a clear thesis early (bold or standalone sentence).
Include 2-4 ideas or mental models with reasoning and tradeoffs.
Structure with ## headings as claims, short paragraphs, and whitespace.
End with an invitation to reach out or discuss.

3) Submit draft via API

Call POST /posts with status: "draft" and required fields.
If the user asked to publish, confirm and set status: "published" with published_at.
Show the user the payload before submitting if anything is inferred.

Output format

Provide the drafted body_markdown, title, summary, and tags for review.
If requested, immediately submit the draft and return the created post ID/slug.

API usage

Use the references/agents.md API spec and examples. Prefer curl for visibility and reproducibility.

Notes

Keep all content in ASCII unless the existing post uses Unicode.
If the user wants revisions, update only the draft content, not unrelated fields.