doc-coauthoring Skill
Skill Claude Code Documents & Content CreationClaude Code Customization & WorkflowThe explanation below is AI-generated. Please verify it against the sources.
doc-coauthoring is a Claude skill that guides users through a structured three-stage workflow for co-authoring documentation such as technical specs, decision docs, proposals, or RFCs. According to the SKILL.md, the stages are Context Gathering (collecting background and asking clarifying questions), Refinement & Structure (building the document section by section through brainstorming, curation, drafting, and iterative edits), and Reader Testing (checking the document with a fresh Claude instance or sub-agent that has no prior context, to catch blind spots). The skill specifies concrete steps for each stage, including using integrations like Slack or Google Drive to pull in context, creating scaffolded documents with placeholder sections, and generating reader questions to test comprehension. It also gives tone guidance (direct and procedural) and final review recommendations before considering the document complete.
What you can do with doc-coauthoring
- 文書の種類・読者・目的・テンプレートについて初期質問を受け、必要な背景情報をまとめて提供できる（Context Gathering）
- Slack、Teams、Google Drive、SharePoint などの連携ツールから関連するチャンネルやドキュメントを取り込める
- セクションごとにブレインストーミング（5〜20個の候補提示）→取捨選択→ドラフト作成→反復編集という流れで文書を構築できる
- artifacts機能または作業ディレクトリ内のMarkdownファイルを使って文書の骨組みを作成し、str_replaceで編集を加えられる
- 文書がおおよそ完成したら、コンテキストのない新しいClaudeインスタンス（またはサブエージェント）に読ませ、読者が抱きそうな質問への回答や曖昧さ・矛盾点をチェックできる（Reader Testing）
- 最終確認として、事実・リンク・技術的詳細の再確認や、意図した効果が達成されているかの検証を行える
Sources
Original description (English)
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.
History of doc-coauthoring
- Skill Added doc-coauthoring