What problem does it solve? Documentation sites silently degrade through broken builds, orphan pages invisible to navigation, stale ADR indexes, and missing LLM output files. This Skill provides a repeatable validation gate that catches these issues before they reach production and erode reader trust. ## Core Features & Use Cases - Build Verification: Runs npx @docmd/core build first to catch broken links, invalid frontmatter, and missing files, with a page-count sanity check to detect silently dropped content. - Orphan Page Detection: Uses shell commands (find, rg, comm) to find markdown pages not linked from any index, then fixes the source index rather than the ephemeral build output. - ADR Index Reconciliation: Compares docs/ADR/adr-*.md files against docs/ADR/index.yaml in both directions, flagging unregistered ADRs and stale entries pointing at deleted files. - LLM Output Audit: Verifies llms.txt, llms-full.txt, and llms.json exist in the build output when llms.enabled is true in docmd.config.json. - Use Case: After adding a new architecture page, run this Skill before pushing to confirm the build passes, the page is linked from docs/index.md, and the site is ready for CI deployment. ## Quick Start Check the docs are in good shape before I push my changes to the documentation site.
