Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
What it does
When you ask Claude to write a document, it writes a document. It doesn't ask what the document is for, who reads it, what they need to do after reading it, or what you already know that should shape the content. This skill enforces a structured co-authoring workflow: context gathering first, then a draft, then targeted revision against specific reader goals. The output isn't just faster — it's a document that actually serves its purpose because that purpose was established before writing started.
Use case
Writing documentation, proposals, technical specs, decision docs, RFCs, or any structured document where the quality of the output depends on understanding the audience and goal. Made by Anthropic.
"Help me write a technical spec for this new API — let's do it properly." "Co-author a project proposal for this client. Start by asking me what you need to know." "Write a decision doc for choosing between these two database approaches." "Help me write a postmortem for last week's incident." "Draft an RFC for this architectural change — go through the co-authoring process."
Tell Claude you want to co-author a document. It starts with context questions: audience, purpose, key decisions the document needs to drive.
Answer the questions. Claude drafts based on your answers — not on generic templates.
Claude then asks you to review the draft against the original purpose and suggests specific revisions.
Input
The type of document you need, the topic, and any initial context. Claude gathers the rest through questions.
Output
A document that serves its stated purpose: right level of detail for the audience, clear structure that drives the intended decision or action, and writing that doesn't need to be rewritten after the first draft.
npx skillsadd anthropics/skills/doc-coauthoring
npx skillsadd anthropics/skills/doc-coauthoring
Requires skills.sh CLI
Create, read, edit, and manipulate Word documents (.docx files) with formatting, tracked changes, and text extraction.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).