test-docs

Run each documented command in an isolated temp directory with explicit environment setup, then compare observed output against the documented output. This Skill automates that process and reports exact commands, outputs, and any drift as executable docs failures.

Documentation review (review-docs) is an adversarial check of accuracy, audience, prose, and completeness. Documentation testing executes the docs' commands, doctests, and link checks to produce evidence that documented behavior actually works.

Commands requiring credentials, live services, or operator-approved environments are not executed. The Skill marks them status=needs-info or records the gap in residual risk rather than falsely claiming they were executed.

Generated references drift when code changes (new flags, changed defaults, renamed commands) are not followed by regenerating the docs. Drift checks compare generated references against current code output and flag mismatches as failures.

Do not use it for writing documentation, prose or audience review, or general code review. It also cannot validate claims that are only inspected, not executed—green claims based solely on reading docs are out of scope.