What you'll get
This skill guides you through three stages of writing important documents: gathering all your context and ideas, building the document section-by-section through brainstorming and refinement, and testing it with a fresh AI to catch gaps before sharing. It's designed for anyone writing PRDs, design docs, decision docs, proposals, or technical specs who wants to ensure their document actually works when others read it.
Step 1 — Get the skill source URL
The Doc Co-Authoring Workflow skill lives at:
Step 2 — Add it to your AI agent
Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.
Claude Code
Add the agent skill from https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring to my project.
Cursor
Install this agent skill: https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring
Codex
Add this skill to .codex/skills/: https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring
Gemini CLI
Add the skill at https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring to my .gemini/skills/ directory.
OpenCode
Install this agent skill from https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring
Windsurf
Add this skill: https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring
Step 3 — Try these prompts
Once the skill is installed, ask your AI things like:
- Writing a product spec, proposal, or decision doc and want it to be clear
- You have a lot of context in your head but need help organizing it into a document
- Make sure your document works for readers who don't have your background
- Starting a substantial writing task and want a structured process instead of a blank page
What this skill does
- Asks clarifying questions to gather all the context you have about the project or decision
- Helps you build each section by brainstorming options, then refining what you keep
- Tests your finished document with a fresh AI (no prior context) to find confusing parts
- Pulls in context from Slack, Google Drive, or other tools if you have them connected
- Creates a structured scaffold for your document type with all the right sections