What problem does it solve? Documentation trees drift over time: new docs land in the wrong place, superseded files linger, README catalogs fall out of sync with the actual files, and stale or orphaned pages accumulate. This Skill enforces placement, archival, and freshness conventions across the docs/ directory so the structure stays consistent. ## Core Features & Use Cases - Doc placement and archival: Places new docs in the correct location with kebab-case or ALL-CAPS naming, and retires superseded docs to docs/archive/<YYYY>/ with an archival header and optional redirect stub. - Whole-tree audits: Reports orphan docs, missing or stale frontmatter, broken relative links, and naming drift, with WARNING findings auto-filed as backlog issues. - README catalog refresh: Regenerates a directory's README catalog from the actual file inventory while preserving operator-authored prose. - Use Case: After a quarter of ad-hoc writing, run an audit to find orphaned and stale docs, archive the superseded ones, and regenerate each directory's README catalog so the docs tree matches reality. ## Quick Start Ask the assistant to audit the docs/ directory for orphans, stale frontmatter, and broken links, then refresh the README catalogs.
