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 skill is a set of instructions that tells an AI agent how to draft long-form content such as blog posts, guides, tutorials, essays and newsletter issues. It is aimed at founders, technical writers and newsletter writers who need polished pieces longer than a paragraph. After this guide you will know what the skill changes about the agent's output, how to install it, how to ask for it in plain language, and where it falls short.
Article Writingaffaan-m/ECC · MIT Download the skill Quick start
- 1Download the ZIP. Get the article-writing ZIP file from this page.
- 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project.
- 3Or upload in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the skill.
- 4Describe your piece. Ask for a blog post, guide, tutorial or newsletter in plain language, and say who it is for.
- 5Add voice references. Provide sample writing or brand guidance so the agent can match the voice.
- 6Review the draft. Check every factual claim against your own sources before you publish.
What does the article-writing skill make the agent do?
Without the skill, an agent tends to produce smooth but generic prose. This skill changes the approach: the agent leads with a concrete artifact, example, output, anecdote, number, screenshot or piece of code, and explains it afterwards. It also keeps sentences tight, uses proof instead of adjectives, and never invents facts, credibility or customer evidence.
The skill includes a list of banned patterns the agent must remove from its draft, such as stock openers like "In today's rapidly evolving landscape", words like "game-changer", and closing questions added only to drive engagement. Before delivering, the agent checks its draft against a short quality gate: factual claims backed by provided sources, no generic AI transitions, voice matching the examples, every section adding something new, and formatting suited to the medium.
- Technical guides: opens with what the reader gets and uses code, commands or concrete output in major sections.
- Essays and opinion: starts with tension or a specific observation, with one argument per section.
- Newsletters: keeps the first screen doing real work and avoids diary filler.
How do you install the article-writing skill?
Download the ZIP file from this page. Unzip it into one of two locations. For a personal install available across projects, use ~/.claude/skills/. For a single project, use the .claude/skills/ folder inside that project.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.
The package contains two files: SKILL.md, which holds the instructions, and agents/openai.yaml. The skill itself is the instruction file, so no separate program needs to be run.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
How do you trigger the skill with a natural request?
You do not need a special command. Describe the piece you want in ordinary language and say what kind of content it is. The skill activates for requests such as drafting a blog post, turning notes or a transcript into an article, or tightening the structure and pacing of a draft you already have.
The skill is most useful when you ask for something longer than a paragraph and care about voice, structure or credibility. Give the agent examples of your writing or brand guidance if you want the output to match a specific voice. If you supply no voice references, the agent defaults to a concrete, unsentimental operator voice.
- "Draft a 1,200-word launch post for our new invoicing feature. Use the attached three posts as voice reference."
- "Turn these interview notes into a tutorial-style article with the setup steps shown in code."
- "Tighten the opening and remove filler from this newsletter issue."
What does the skill need, and what are its safety notes?
The source lists no required dependencies. The skill does not run scripts and does not use the network. It is a text instruction file, so it works by shaping how the agent writes rather than by performing actions on your machine or online.
For voice matching, the skill tells the agent to run a separate skill called brand-voice first and reuse its VOICE PROFILE output, rather than doing a second style analysis. If you want voice matching, that companion skill is needed. The skill is licensed under MIT.
- Requires: nothing listed in the source.
- Runs scripts: no.
- Uses network: no.
- Voice matching refers to the brand-voice skill's VOICE PROFILE.
What are the best tips for getting good drafts?
Supply real material. The skill tells the agent not to invent facts, but it cannot check claims for you. Provide notes, data, screenshots or code so the draft has proof to lead with.
Be explicit about the medium and the reader. The skill's structure guidance differs for technical guides, essays and newsletters, so naming the format helps the agent choose the right shape.
- Attach two or three writing samples when you want a particular voice.
- Say whether the piece is a tutorial, essay or newsletter so the right structure applies.
- Check every number and claim before publishing, since the skill cannot verify them.
- Ask for a short outline first if you want to approve the structure before a full draft.
What people use it for
- Drafting a founder's launch post that sounds like them, using earlier posts as voice reference.
- Writing a technical tutorial where each major section includes code or commands.
- Tightening the opening and cutting filler from a weekly newsletter issue.
- Turning interview notes or a transcript into a structured long-form article.
Frequently asked questions
Is the article-writing skill free?
The skill is published under the MIT licence, as stated in its SKILL.md file. Check the licence text in the package for the full terms.
What do I need to use the article-writing skill?
The source lists no requirements. The skill does not run scripts or use the network, so it is an instruction file that works through your agent.
How do I install the article-writing skill?
Unzip the downloaded ZIP into ~/.claude/skills/ for personal use or into .claude/skills/ in a project. In the Claude apps, upload it under Settings, Capabilities, Skills.
Will the skill make the agent write facts I can publish without checking?
No. The skill tells the agent never to invent facts, credibility or customer evidence. It cannot verify claims, so you need to check every fact yourself before publishing.
Does the skill work for short copy like captions?
It is designed for content longer than a paragraph. For captions or one-paragraph replies, a general prompt will usually be simpler.
How does the skill match my writing voice?
If you supply examples, the agent runs the brand-voice skill first and reuses its VOICE PROFILE. Without references, it defaults to a sharp, concrete operator voice.
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 want blog posts, tutorials or newsletters that lead with concrete proof and avoid stock AI phrasing, especially when you can supply voice samples and source material. Pick something else for short copy such as captions, or for fact-heavy pieces where you have no sources, since the skill cannot verify claims.
Download the skill