What problem does it solve? Documentation drifts out of sync as files are renamed and headings change, leaving broken internal links and dead anchors that frustrate readers. This Skill scans every markdown file in a repository, validates internal references, and automatically repairs unambiguous cases while logging ambiguous ones for human review. ## Core Features & Use Cases - Link and anchor validation: Checks inline links to other markdown files, same-file anchor links, and cross-document anchors using GitHub-flavored slug rules. - Git-history-aware auto-fixing: Traces file renames through git history and rewrites links when exactly one unambiguous new path is found. - Deferred findings logging: Records ambiguous broken references (missing anchors, unclear rename lineage) to a memory file for later triage instead of guessing. - Use Case: After a refactor that moves documentation files, run this Skill to detect link drift, automatically repair links whose targets were renamed, and receive a structured report of fixes applied and findings logged. ## Quick Start Ask the agent to check the documentation for broken internal links and fix the ones that can be resolved unambiguously.
