critique-docs

Reviews a markdown documentation page or page tree against the Diataxis framework: whether each page keeps to the mode it commits to (tutorial, how-to, reference, or explanation), whether the tree's heading structure, page linking, and navigation listings hold together the way a Diataxis tree assumes. Artifact claim (v0.1, narrow): markdown documentation pages and page trees only. This skill does not critique a live rendered documentation site's behavior, non-markdown source formats, or the technical correctness of code samples inside a page; it critiques the page and tree structure and the mode each page keeps to, exactly as references/DIATAXIS.md's nine criteria define.

Contract

Every finding this skill emits conforms to contract/critique-contract.schema.json. See docs/reference/critique-contract.md for the field contracts a schema cannot check on its own: location navigable unaided, evidence quoted or measured rather than characterized, violation naming the breach, fix actionable and specific.

Protocol