alterlab-link-health

# Link Health — Repo-wide Markdown Link Audit Methodology A reusable methodology for bringing a broken docs-heavy repo's link checker to green. Codified from a real audit that took `AlterLab-IEU/AlterLab-Academic-Skills` from **1208 errors out of 1966 links** to **0 errors out of 1912 links** across 8 commits, with an auto-detected Tier 3 regression that validated the guardrail rule. ## Quick Start **Full audit (fresh repo, failing link checker):** ``` Audit and repair the link health of <owner/repo>. Run the full four-tier pipeline. ``` → Dispatch the 10-agent audit from `playbooks/full-audit.md`, then the tiered APPLY phase. **Targeted residual pass (first dispatch reduced errors but some remain):** ``` The link checker is down from 1208 to 67 errors. Close the residuals. ``` → Dispatch the 3-agent followup pass from `playbooks/followup-pass.md`. **Post-merge cleanup (PR is green, need to finalize human-decision items):** ``` Finalize the post-merge cleanup: resolve pending human-decision items, file follow-up issues, document link debt. ``` → Dispatch the 4-agent post-merge pass from `playbooks/post-merge.md`. --- ## Trigger Conditions ### Trigger Keywords **English**: link audit, dead links, link health, lychee, broken links, link checker, markdown link audit, link-health audit, 404 audit, check-links failing, CI link-check **繁體中文**: 連結健檢, 死鏈, 失效連結, 斷鏈檢查, 連結審計 ### When This Skill Applies - A weekly `Check Links` (or similar lychee / markdown-link-check) wor...