Guide · Agent skill
How to use the Blog Post Draft Workflow agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The blog-draft skill is an instruction package that tells an AI agent to write a blog post step by step instead of producing one long article at once. It is useful for writers, content teams and anyone who wants sources gathered, an outline approved and drafts kept as numbered versions. After this guide you will know how to install the skill, ask for it in plain language and review what it produces.
Blog Post Draft Workflowluongnv89/claude-howto · MIT Download the skill Quick start
- 1Download and unzip. Download the skill ZIP from the directory page and unzip it into ~/.claude/skills/ or the project's .claude/skills/ folder.
- 2Or upload in the Claude apps. In the Claude apps, open Settings → Capabilities → Skills and upload the skill.
- 3Make the request. Describe the blog post topic and add any URLs, files, audience or tone.
- 4Answer the brainstorm questions. Reply to the questions about the main takeaway, sources to highlight and target length.
- 5Approve the outline. Review the proposed structure and approve it or request changes.
- 6Review draft-v0.1.md. Read the draft and its source list, then send specific corrections.
- 7Approve the final version. When satisfied, approve the draft so the agent can summarise the process and optionally rename it final.md.
What the blog-draft skill makes the agent do
An agent skill is a folder with a SKILL.md file that gives an agent extra instructions for a specific task. This skill covers blog post drafting. When you ask for a blog post, the agent follows a fixed sequence rather than writing in one go.
It creates a dated project folder, gathers and summarises your sources into a resources folder, and proposes a brainstorm and outline. It waits for your approval before writing. The draft is then saved as draft-v0.1.md with inline citations and a source list, and later rounds of feedback produce draft-v0.2.md, draft-v0.3.md and so on.
- Creates blog-posts/YYYY-MM-DD-topic-name/ with a resources/ subfolder
- Writes a source summary file for each resource
- Saves the approved plan as OUTLINE.md
- Saves drafts with numbered versions
- Asks for a final approval before finalising
Install the blog-draft skill
Download the ZIP for the skill from the directory page and unzip it. For a personal setup, place the skill folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.
In the Claude apps you can instead upload the skill under Settings → Capabilities → Skills.
- Personal: unzip into ~/.claude/skills/
- Project only: unzip into the project's .claude/skills/
- Claude apps: Settings → Capabilities → Skills, then upload
Trigger the skill with a natural request
You do not need a special command. The skill description tells the agent to use it when you want to write a blog post, turn research into content or prepare an article. Say what the post is about, and add any sources, audience or tone you have.
The skill also accepts a request to update an existing post. In that case the agent reads the current draft files and starts from the revision step rather than repeating the research.
- Give the topic, any URLs or files, the audience and the tone (all optional except the topic)
- Ask to revise an existing post by naming its folder or draft file
Example requests and what to expect
A typical first request names the topic and links to research. The agent will create the folder, summarise the sources and then ask you questions about the main takeaway and target length before proposing an outline.
Answer the questions, approve or change the outline, and the draft follows. Review it, reply with corrections, and the agent saves a new version.
- Example: "Write a blog post about remote onboarding using these three links, for team leads, practical tone."
- Example: "Update the existing post in blog-posts/2025-01-10-remote-onboarding, shorten section 2."
- Expect pauses for your approval at the outline and draft stages
Check what the skill needs and its safety notes
The skill needs an agent that can read and write files in the working directory. It uses web search or URL access to gather sources, so the agent makes network requests. Git is optional: if the folder is a git repository, the skill commits the outline and drafts and pushes them to the remote.
The skill does not run scripts. Its risk is editorial rather than technical: it asks the agent to cite sources, but the agent can still misquote or invent references, so check every citation before publishing. The instructions are written in Ukrainian; you can still give requests in another language, but review the output carefully.
- Requires file read and write access in the working directory
- Uses network access for web search and URLs
- Runs scripts: no
- Git push happens only if the folder is a git repository
- Verify all citations and statistics before publishing
Tips for better drafts
The quality of the draft depends mostly on the sources and the answers you give at the brainstorm stage. Provide the URLs or files you trust, and state the main takeaway clearly so the outline has a point.
Use the version files to compare changes. Because each round is saved separately, you can return to an earlier draft if a revision goes the wrong way.
- Supply your own sources rather than relying only on web search
- State one main takeaway and a target length such as 500-800, 1000-1500 or 2000+ words
- Keep feedback specific, for example which section to expand or which tone to change
- Read the citation list against the original sources
What people use it for
- Turning a set of research links into a structured article with a source list
- Drafting a long-form post for a content team that needs traceable statistics
- Revising an existing blog post section by section while keeping old versions
- Preparing a plan for a post before any prose is written
Frequently asked questions
How do I install the blog-draft skill?
Download the ZIP from the directory page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can upload it under Settings → Capabilities → Skills.
What does the blog-draft skill require?
It needs an agent that can read and write files in the working directory. It uses web search or URL access to gather sources. Git is optional and only used to commit and push if the folder is a repository.
Is the blog-draft skill free?
The skill is published under the MIT licence. The source material does not state pricing for the agent or any service it uses, so check the terms of your own agent product.
Does the skill run scripts or access the network?
It does not run scripts, according to the listing. It does use the network, because web search and URL access are used to gather sources.
Can I use blog-draft for short social posts?
It is not recommended. The multi-step approval process is heavy for quick social posts or short copy, though it is not risky to use.
Can the skill's citations be trusted without checking?
No. The skill asks the agent to cite sources, but the agent can still misquote or invent references, so verify every citation before publishing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use blog-draft if you want help researching, structuring and revising a post with traceable citations and a versioned history. Skip it for quick social posts or short copy, where the approval steps slow you down, and always verify citations before you publish.
Download the skill