Write Good Docs

Use this skill when documentation needs to become more useful, not merely longer.

Layout

• references/diataxis/ contains the Diataxis framework reference for classifying documentation into tutorials, how-to guides, reference, and explanation.
• references/crafting-effective-readmes/ contains README templates, checklists, and style guidance.
• references/ai-writing-tropes/ contains prose cleanup guidance for removing common AI-generated writing tells.

Reading Order

Do not read the whole skill directory by default.

1. Classify the documentation task.
2. Load only the relevant reference area below.
3. Write or edit the docs.
4. Run the AI-writing trope check before finalizing prose.