# 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.

- Skill: `majiayu000/draft-article-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/draft-article-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/draft-article-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/majiayu000/draft-article-3

---


# 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.