mapslisted
Install: claude install-skill mgifford/accessibility-skills
# Maps Accessibility Skill
> **Canonical source**: `examples/MAPS_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 implementing or reviewing any static or interactive map.
**Only load this skill if the project contains maps.**
---
## Core Mandate
All users must access the essential information conveyed by a map through
accessible alternatives, keyboard-operable controls, and clear structured content.
---
## Severity Scale (this skill)
| Level | Meaning |
|---|---|
| **Critical** | Essential location data has no accessible alternative |
| **Serious** | Interactive map unreachable by keyboard; `role="application"` misused |
| **Moderate** | Skip link missing; colour independence gap; popup focus not managed |
| **Minor** | Missing `prefers-reduced-motion` for animations; legend incomplete |
---
## Critical: Text Alternatives for Static Maps
A meaningful map with no text alternative is **Critical** — blind users receive
no location information at all.
```html
<!-- Simple map -->
<img src="campus-map.png"
alt="Campus map: main entrance on Elm Street,
library to the north, parking to the east.">
<!-- Complex map with extended description -->
<figure>
<img src="regional-map.png"
alt="Regional accessibility map — detailed description below."
aria-describedby="map-desc">
<figcaption id="map-desc">
<p>Three accessi