Doc Co-Authoring Workflow
OfficialAn official skill that guides you and Claude through a three-stage process for writing proposals, specs, and decision docs.
Docs & OfficeBeginner★ 167,132⑂ 19,920AI score 9/10Last updated: Aug 7, 2026
What it does
Instead of just ghostwriting, Claude acts as a writing process guide:
- Context Gathering — asks about doc type, audience, desired impact, and templates; lets you info-dump freely, then follows up with 5–10 clarifying questions.
- Refinement & Structure — per section: brainstorm 5–20 candidate points → you keep/cut/merge → draft → surgical edits via
str_replaceinstead of reprinting the whole doc. - Reader Testing — hands the document to a fresh Claude (sub-agent) with zero conversation context and probes it with realistic reader questions to surface ambiguity, hidden assumptions, and contradictions.
Who it's for
- PMs and engineers who regularly write PRDs, RFCs, design docs, decision docs
- Writers who can draft but worry "will anyone else actually understand this?"
- Team leads standardizing documentation quality
Examples
- Technical spec: "Write a spec for refactoring the payments module" → Claude probes rejected alternatives and rollback plans, then builds it section by section.
- Decision doc: Paste a team discussion thread; Claude organizes context, options, trade-offs, and decision, then Reader Claude flags "it's unclear why option B was rejected."
- Exec proposal: For a one-pager, brainstorm 20 points and keep only the 5 that matter, producing a tight, filler-free document.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/doc-coauthoring folder from the GitHub repo anthropics/skills into my ~/.claude/skills/doc-coauthoring/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/anthropics/skills.git && mkdir -p ~/.claude/skills && cp -r skills/skills/doc-coauthoring ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the skills repository:
git clone https://github.com/anthropics/skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy this skill over:
cp -r skills/skills/doc-coauthoring ~/.claude/skills/ - Verify that
~/.claude/skills/doc-coauthoring/SKILL.mdexists. - Restart Claude Code and try a prompt like "let's write a product proposal together".
- When Claude offers the three-stage workflow versus freeform writing, pick whichever fits your deadline.