doc-coauthoring
Installation
SKILL.md
Doc-Coauthoring
Use this skill when the user wants to author, improve, or expand documentation through structured co-authoring. Documentation benefits from separated concerns—context discovery, structural design, content iteration, and validation through real readers—rather than a single linear draft-and-polish pass.
This skill splits the work into three stages: gather context and constraints, refine structure and content, and validate with reader feedback.
Use this skill when
- The user wants to write a new document (README, guide, API reference, runbook, specification, architecture decision record).
- The user wants to significantly improve or refactor existing documentation.
- The user wants to expand documentation to cover new features, breaking changes, or updated workflows.
- The user wants structured feedback on documentation clarity or completeness before releasing it.
- The documentation will be read by multiple audiences (contributors, operators, end users) and needs to serve different goals.