RESEARCH AND DOCUMENTATION / Anthropic
Anthropic Documentation Coauthoring
Guides a human and agent through audience discovery, section-by-section drafting and a separate-reader review of a substantial document.
“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”
01 / THE REASONING
Why this made the selection.
- Starts with the audience, intended impact and missing context, then lets the author curate ideas before the agent drafts each section.
- Adds a reader-question pass with a fresh conversation or subagent, giving unclear assumptions a concrete route back into revision.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/doc-coauthoring/SKILL.md
- README.md (installation, compatibility and licence sections)
Our findings
- The complete definition has opt-out/freeform and manual-reader fallbacks, and separates brainstorming from edits to the working document.
- Reader testing receives the document and questions rather than the full authoring conversation; sharing a draft or chat appendix can still reveal sensitive context.
- The create-file versus replace-text guidance needs adaptation to the host so section edits do not overwrite the whole document.
Not established by this review
- No document was coauthored or evaluated with readers.
- Artifact editing, connectors and context isolation were not exercised.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- Install or load the upstream skill through the publisher guidance; this catalogue does not provide its source text.
- Choose a local Markdown or host artifact workflow, and agree which documents or connectors the agent may use.
Before you start
- A Claude environment that can load the skill
- A draft, audience description and any required source material; connected accounts only for sources you authorize
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/anthropics/skills/blob/34040c9c568585f6929bedeaad110ad08f079624/skills/doc-coauthoring/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/anthropics/skills/blob/34040c9c568585f6929bedeaad110ad08f079624/README.md
Supports: install, compatibility, access, license