Guide · Agent skill
How to use the Article Writing agent skill (article-writing)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Article Writing agent skill (article-writing) is a set of instructions that tells an AI agent how to write long-form content such as blog posts, essays, tutorials and newsletter issues so it reads like a specific person wrote it. This guide explains what the skill changes, how to install it from the ZIP on this page, how to trigger it with plain requests, and what to check before you rely on it. By the end you will be able to ask an agent for a draft or an edit using this skill and know what to expect.
Quick start
- 1Download and unzip. Download the ZIP from this page and unzip it so you have a folder containing SKILL.md.
- 2Place the skill folder. Move it into ~/.claude/skills/ for all projects, or into the project's .claude/skills/ folder for one project.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Supply your material. Gather your notes, transcript, data or draft, and a sample of your writing if you want a specific voice.
- 5Ask in plain language. Describe the piece, its medium and length, and whether you want a new draft or an edit.
- 6Check the output. Verify each fact against your sources and review the items the agent could not confirm.
What the Article Writing skill makes the agent do
The skill is a single instruction file, SKILL.md. It asks the agent to lead with concrete evidence such as artifacts, examples, outputs, anecdotes, numbers, screenshots or code, rather than with general claims. It also asks the agent to explain things after an example rather than before it, and to use evidence instead of adjectives.
Before delivering a draft, the skill asks the agent to check it against a quality list: factual claims must be supported by the source you provided, generic AI transitions must be gone, the voice must match your example or agreed voice profile, every section must add something new, and the format must suit the medium.
- Avoids stock phrases such as "in today's fast-paced environment" and words like "game-changer" or "cutting-edge".
- Removes filler such as closing questions added only to boost engagement and biography that does not support the argument.
- Gives structure guidance for technical guides, essays and newsletters separately.
Install the skill from the ZIP
Download the ZIP for this skill from this page and unzip it. The skill is delivered as a folder containing SKILL.md. Put that folder in one of the following locations, depending on whether you want it for all projects or one project.
To make it available in your user-level skills folder, unzip it into ~/.claude/skills/. To make it available only inside one project, unzip it into that project's .claude/skills/ folder.
If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.
- User-wide: ~/.claude/skills/
- Single project: the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload
Trigger the skill with natural requests
You do not need a special command. Describe the long-form piece you want in ordinary language and say what kind it is. The skill's description covers articles, guides, blog posts, tutorials, newsletter issues and other long content, and it is meant for work where voice consistency, structure and credibility matter.
If you want a particular voice, give the agent an example of your writing or your brand guidance. The skill says the agent should first run the brand-voice skill and reuse its VOICE PROFILE, rather than inventing a style of its own. Without a voice reference, the agent falls back to a sharp, plain, useful operator voice.
- "Draft a 1,200-word blog post on how we cut our deploy time, using my notes below."
- "Turn this call transcript into a newsletter issue in my voice. Here is a sample of my writing."
- "Edit this guide for structure and pacing, and flag any claim that has no support in the text."
Examples of what to ask for
The skill works best when you supply the raw material. It does not research topics, so give it your notes, transcripts, data or a finished draft to tighten. Ask for a specific medium and length so the agent can choose the right structure.
For a technical guide, ask the agent to open with what the reader will get and to include the commands or output from your own tests. For an essay, ask it to open with a tension or a specific observation and keep one argument per section.
- Technical guide: provide the commands and output you actually ran.
- Essay or opinion piece: provide your position and the evidence behind it.
- Newsletter issue: provide the week's real work, so the first screen contains substance.
What the skill needs and safety notes
The skill's listed requirements are nothing. It does not run scripts and does not use the network, according to this skill's listing. Its only file is SKILL.md, so there are no bundled programs to review beyond that text.
The skill is not suited to factual or medical articles where the agent would have to research sources it cannot access, because it forbids invented facts but does not supply research. Keep the source check on your side: the skill relies on the material you provide.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Still verify every fact, number and quote yourself before publishing.
Tips for better drafts
Give the agent a real example of your writing rather than a description of your tone. A paragraph you wrote is more useful than the adjectives "friendly and professional". If you already have a draft, ask for an edit pass first, so the agent works on structure and unsupported claims before rewriting sentences.
Ask the agent to run its quality check and report which items it could not confirm. That tells you where your source material is thin.
- Paste your own sample paragraphs as the voice reference.
- Ask for an edit of structure and pacing before a line edit.
- Request a list of claims the draft cannot support from your material.
What people use it for
- Drafting a launch post for a product update using the team's own notes and screenshots.
- Turning a call transcript or research notes into a newsletter issue in the founder's voice.
- Editing an existing long guide for structure, pacing and unsupported claims.
- Writing a technical tutorial that leads with the commands and output the reader will see.
Frequently asked questions
Is the Article Writing agent skill free?
The skill is published under the MIT licence, as listed on this page. The listing shows no price and requires nothing else to run.
Do I need to install anything else to use it?
The listing says it requires nothing and does not run scripts or use the network. You add the skill folder to your skills location and use it with an agent that supports skills.
Where do I put the skill files?
Unzip the download into ~/.claude/skills/ for user-wide use, or into a project's .claude/skills/ folder for one project. In the Claude apps you can upload it under Settings → Capabilities → Skills.
Will the skill research my topic for me?
No. The skill forbids inventing facts but does not supply research, so it relies on the notes, transcripts and data you provide. It is not suited to factual or medical articles that need sources the agent cannot access.
How is this different from a brand-voice skill?
The Article Writing skill covers structure, evidence and quality checks for long-form pieces. When you need a specific voice, it tells the agent to run the brand-voice skill and reuse its VOICE PROFILE instead of creating a second style analysis.
Can it write short copy like captions or taglines?
Not well. The skill is designed for long-form content, and the listing says very short copy such as captions or taglines is not what it is for.
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 this skill if you regularly draft or edit blog posts, guides, essays or newsletter issues and want them to sound like a specific person with evidence to back them. Pick something else if you need research on factual or medical topics, or short copy such as captions and taglines.
Download the skill