Agent skill · Anthropic

Doc Co-authoring skill for Claude Code, Codex and Cursor

Walks you through drafting specs, proposals and design docs step by step with Claude.

Officialname: doc-coauthoring★ 184k (repo)pushed 2026-10-09SKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

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.

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install Doc Co-authoring

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add anthropics/skills --skill doc-coauthoring

This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (document-skills, example-skills, claude-api, academy-guide...), or copy only this skill into ~/.claude/skills. docs

/plugin marketplace add anthropics/skills
/plugin install <plugin>@anthropic-agent-skills

# or only this skill:
npx skills add anthropics/skills --skill doc-coauthoring -a claude-code

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/anthropics/skills.git /tmp/doc-coauthoring-src
cp -r /tmp/doc-coauthoring-src/skills/doc-coauthoring ./doc-coauthoring
zip -r doc-coauthoring.zip doc-coauthoring

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add anthropics/skills --skill doc-coauthoring -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install anthropics/skills doc-coauthoring

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add anthropics/skills --skill doc-coauthoring -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/anthropics/skills.git --path skills/doc-coauthoring

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add anthropics/skills --skill doc-coauthoring -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add anthropics/skills --skill doc-coauthoring -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

What's in the SKILL.md

26 sections

When to Offer This Workflow
Stage 1: Context Gathering
Initial Questions
Info Dumping
Stage 2: Refinement & Structure
Step 1: Clarifying Questions
Step 2: Brainstorming
Step 3: Curation
Step 4: Gap Check
Step 5: Drafting
Step 6: Iterative Refinement
Quality Checking
Near Completion
Stage 3: Reader Testing
Testing Approach
Step 1: Predict Reader Questions
Step 2: Test with Sub-Agent
Step 3: Run Additional Checks
Step 4: Report and Fix
Step 1: Predict Reader Questions
Step 2: Setup Testing
Step 3: Additional Checks
Step 4: Iterate Based on Results
Exit Condition (Both Approaches)
+ 2 more

Facts

Skill name: doc-coauthoring
Publisher: Anthropic (official)
Repo: anthropics/skills
SKILL.md size: 2,404 words, 371 lines
Repo stars: 184k (as of 2026-10-24)
SKILL.md checked: 2026-11-07

More skills from anthropics/skills

Canvas Design: Produces posters and static artwork as PNG or PDF files, guided by a written design philosophy.
Claude API: Reference for building on the Claude API and Anthropic SDKs: models, tool use, streaming, caching, pricing.
Word Documents (DOCX): Creates, reads and edits Word .docx files, including templates, tracked changes and formatting.
Frontend Design: Steers UI work toward deliberate visual direction and typography instead of generic template looks.
MCP Server Builder: Guide for designing and building Model Context Protocol servers that wrap external APIs as tools.
PDF: Extracts text and tables, merges, splits, fills forms and creates PDF files.
PowerPoint (PPTX): Builds, reads and edits PowerPoint decks and templates, including layouts and speaker notes.
Skill Creator: Helps write new skills, refine existing ones and test how well they trigger and perform.
Slack GIF Creator: Makes small animated GIFs sized and validated for Slack's emoji and message limits.
Web Artifacts Builder: Builds multi-component HTML artifacts with React, Tailwind and shadcn/ui, bundled into one file.
Web App Testing: Uses Playwright to drive a local web app, check behavior, read console logs and take screenshots.
Excel Spreadsheets (XLSX): Opens, cleans, edits and creates spreadsheets (.xlsx, .csv), including formulas and charts.

Related writing & notes skills

PR Writer · Sentry
JSON Canvas · Steph Ango (kepano)
Obsidian Markdown · Steph Ango (kepano)

FAQ

What does the doc-coauthoring skill do?+

Walks you through drafting specs, proposals and design docs step by step with Claude. In its own SKILL.md, Anthropic describes it as: "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."

How do I install the doc-coauthoring skill?+

Run npx skills add anthropics/skills --skill doc-coauthoring and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/doc-coauthoring/SKILL.md; in Codex and Cursor in .agents/skills/doc-coauthoring/.

Does Doc Co-authoring work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains Doc Co-authoring?+

Anthropic, the company or project behind it, in the anthropics/skills repo on GitHub, last pushed 2026-10-09.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers