docs-validating-linkslisted

# Validating Markdown Links This Skill provides comprehensive guidance for validating markdown links across the repository, including internal link validation, external link verification, and checker implementation strategies. ## Purpose Use this Skill when: - Implementing link validation in checker agents - Validating internal documentation links - Verifying external URL accessibility - Checking site link formatting - Implementing link caching strategies - Understanding link validation patterns ## Link Validation Principles ### Why Link Validation Matters **Broken links**: - Break user navigation experience - Reduce documentation credibility - Create maintenance burden (hard to find broken links manually) - Indicate structural issues (moved/deleted files) **Link validation**: - Prevents broken links from reaching production - Catches file renames and moves - Validates external resources still exist - Ensures consistent link formatting ### Validation Scope **What to validate**: - Internal markdown links (docs/, repo-governance/, plans/) - External URLs (HTTP/HTTPS) - Image links (relative paths) - Anchor links (same-page headings) **What NOT to validate**: - Links in code blocks (examples, not actual links) - Links in quoted text (preserved formatting) - Commented-out links (intentionally disabled) ## Internal Link Validation ### Required Link Format **Documentation files** (docs/, repo-governance/, plans/, root .md files): ✅ PASS: [File Naming Convention](