docs-writing-style
Installation
SKILL.md
Docs writing style
Two modes. Choose one per session.
| Mode | When to use | What you get |
|---|---|---|
| Handoff | Before writing: you want your coding agent (Claude/Cursor/Copilot) to match the existing voice | A self-contained prompt block to paste into your coding agent's system instructions |
| Review | After drafting: you want to check your draft's tone, structure, and style before submitting | A rubric-based diagnosis: what passes, what needs fixing, in priority order |
State your mode at the start: "handoff" or "review."
Core principle
Documentation voice is a contract with the reader. Inconsistent tone makes docs feel untrustworthy. Consistent tone, even across many contributors, makes readers confident the information is accurate.