Agent Docs Writer
How to write skills and AGENTS.md files an agent follows reliably.
What it does
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
Install in under a minute
Mac or Linux, after you download
unzip agent-docs-writer.zip -d ~/.claude/skills/Windows PowerShell
Expand-Archive agent-docs-writer.zip -DestinationPath $HOME\.claude\skills- Start a new Claude Code session so it sees the skill.
- Ask in plain words, for example: "Use Agent Docs Writer on this project."
- Unzip the download, then zip just the agent-docs-writer folder if your computer added an extra folder.
- In Claude.ai, open Settings, then Capabilities, and upload it under Skills.
- Turn the skill on and ask Claude to use it.
Agent Docs Writer uses the open SKILL.md format, so it also works in agents like Cursor, Gemini CLI, GitHub Copilot and Codex. Copy the agent-docs-writer folder into that agent's skills folder, for example .cursor/skills/ or .github/skills/ in your project.
What's inside
The 7 main sections of the SKILL.md, in order.
- Context pointers
- The two loads
- Information hierarchy
- Steps and completion criteria
- When to split
- Leading words
- Pruning
In the download: agents/openai.yaml, LICENSE, NOTICE.md, SKILL-MECHANICS.md, SKILL.md
Credit and license
Agent Docs Writer is a renamed, packaged copy of writing-for-agents by Matt Pocock (github.com/mattpocock/skills), used under the MIT license. The license and a list of changes ship inside the download.
Questions
Does Agent Docs Writer work in Claude.ai, not just Claude Code?
Yes. In Claude.ai, upload the agent-docs-writer folder as a zip in Settings under Capabilities. It also works in other agents that support Agent Skills, like Cursor, Gemini CLI and GitHub Copilot.
What do I get?
A zip with the agent-docs-writer folder: its SKILL.md (2,662 words) and its license files. One payment, instant download.
Who made Agent Docs Writer?
It's a renamed, packaged copy of writing-for-agents by Matt Pocock, used under the MIT license. The license and a list of changes ship inside the download.