Rebuild mkdocs-material sites and detect broken links and ADR drift.
npx skills add https://github.com/VMAFx/vmafx --skill regen-docs
Please help me install this Agent Skill. Skill: regen-docs Source: https://github.com/VMAFx/vmafx/tree/main/.claude/skills/regen-docs Command: npx skills add https://github.com/VMAFx/vmafx --skill regen-docs
This Skill rebuilds the documentation site and exposes broken links, stale references, and ADR drift before they reach readers.
Ask the assistant to regenerate the documentation site in strict mode and report any broken links, ADR mismatches, and suspicious page removals.
High-intent search queries and answers about installing and using this skill.
To detect broken cross-references in an mkdocs-material site, rebuild the documentation with strict validation enabled. This surfaces actionable doc-to-doc cross-reference issues while ignoring expected source-tree references that cannot resolve inside the site.
ADR drift occurs when architecture decision records fall out of sync with repository filenames. You check ADR index coherence by running a validation process that verifies filename consistency and matches the ADR index against actual repository contents.
Validate documentation links before a release readiness check by regenerating your site with strict build validation. This process catches stale links and broken navigation, then compares the new output with the previous build to spot suspicious page deletions.
Yes, you can find stale links and suspicious page removals by comparing new site output against the previous run. This output diff comparison highlights unexpected deletions and stale references before they reach readers.
Documentation site builds ignore source-tree references during link validation because those references point to repository source files rather than site pages. The validation process specifically targets doc-to-doc cross-reference issues that can resolve inside the generated site.
The best way to catch link drift in repository maintenance is to run a documentation quality gate that categorizes link drift and enforces strict build validation. This exposes broken links and stale references during local site regeneration.
PelekeGenerate llms.txt and llms-full.txt files from MkDocs navigation and markdown content.
webdevcodyAnalyze branch diffs to produce pre-publish release risk briefings.
janewilkinLints Python code with ruff and checks types with mypy.
skerishKangRun node --check and regex scans on JavaScript and HTML runtime patches.
