What problem does it solve? Project documentation drifts out of sync with code, mixes document types on one page, and ships with untested examples and broken badges. This Skill classifies each document by type, verifies every claim against the source, and keeps READMEs, tutorials, references, ADRs, and changelogs accurate and readable. ## Core Features & Use Cases - Document classification and writing: Applies the tutorial / how-to / reference / explanation taxonomy with per-type rules, title patterns, and validation questions before any prose is written. - Docs-against-code audits: Establishes the source of truth first, settles every checkable claim (symbols, defaults, environment variables, links), and reports findings ranked by reader cost with cited lines on both sides. - README composition and portability: Covers first-screen layout, badge selection and failure modes, and a measured support matrix for how constructs render across forges and package registries. - Changelogs and ADRs: Turns commit logs into Keep a Changelog files with the six standard types and breaking-change markers, and writes ADRs that match the repository's existing convention. - Use Case: Before a release, ask for a docs audit: the Skill compares every documented command, parameter, and environment variable against the current source and returns a ranked findings report with proposed fixes. ## Quick Start Ask the agent to audit the project's README and documentation against the current source code and report every stale claim with its evidence.
