regen-docs

What problem does it solve?

This Skill rebuilds the documentation site and exposes broken links, stale references, and ADR drift before they reach readers.

Core Features & Use Cases

• Regenerates the mkdocs-material site from the repository root with strict validation enabled.
• Surfaces actionable doc-to-doc cross-reference issues while ignoring expected source-tree references that cannot resolve inside the site.
• Checks ADR index coherence and filename consistency, then compares the new site output with the previous run to spot suspicious deletions.
• Use it when you need a safe documentation quality gate, a release-readiness check, or a quick audit of broken navigation.

Quick Start

Ask the assistant to regenerate the documentation site in strict mode and report any broken links, ADR mismatches, and suspicious page removals.