anchor-linkslisted

# Anchor Links Accessibility Skill > **Canonical source**: `examples/ANCHOR_LINKS_ACCESSIBILITY_BEST_PRACTICES.md` in `mgifford/ACCESSIBILITY.md` > This skill is derived from that file. When in doubt, the example is authoritative. Apply these rules when creating or reviewing in-page anchor links, skip links, or heading links. **Only load this skill if the project contains in-page navigation or skip links.** --- ## Core Mandate Every anchor link must have meaningful text, a reachable target with a visible focus indicator, and must not cause motion-related harm. --- ## Severity Scale (this skill) | Level | Meaning | |---|---| | **Critical** | Anchor navigation blocks access or causes a trap | | **Serious** | Skip link broken or permanently hidden; smooth scroll triggers vestibular harm | | **Moderate** | Focus indicator obscured by sticky header; link text ambiguous in context | | **Minor** | Non-slug IDs; missing `aria-current` in table of contents | --- ## Serious: Meaningful Link Text Link text must make sense out of context — screen reader users navigate by tab and by extracted link lists. ```html <!-- Bad — Serious issue if used throughout --> <a href="#section">Click here</a> <a href="#section">Read more</a> <!-- Good --> <a href="#installation">Installation instructions</a> <a href="#wcag-criteria">Relevant WCAG success criteria</a> ``` When visible text cannot be changed (icon-only heading links): ```html <!-- "Link to" is redundant — screen readers alrea