What problem does it solve? Documentation drifts out of sync with code, mixes audience types, and ships examples that do not run. This Skill enforces a disciplined writing workflow so every README, guide, or reference page stays accurate, focused on one reader, and updated in the same change as the code it describes. ## Core Features & Use Cases - Diataxis classification: Forces each page into exactly one mode — tutorial, how-to guide, reference, or explanation — with a named audience and single goal. - Runnable examples first: Requires minimal copy-paste runnable snippets with pinned versions and expected output for any executable example. - Accuracy gate: Mandates updating docs alongside code changes, verifying example output, and passing docs-as-code CI checks like markdownlint, Vale, and link checkers. - Use Case: After changing a CLI flag in your project, use this Skill to rewrite the README quickstart and how-to guide so the documented commands match the new behavior before merging. ## Quick Start Ask the agent to write or update the README quickstart for your project following the write-docs workflow.
