How-to · Writing · By Anthropic

How to use Doc Co-Authoring Workflow in your AI agent

Install and use the Doc Co-Authoring Workflow skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

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
Made byAnthropic
CategoryWriting