accessibility-annotations
Installation
SKILL.md
Accessibility Annotations
Annotate Figma screens with accessibility (AX) annotations so engineers know the reading order, focus order, roles, labels, and alt text for every element.
Work is Figma-first: use the annotation library configured for the project. Never invent components or draw homemade highlight shapes.
Project configuration
This skill is design-system agnostic. Resolve these values before the first write, from the project handoff, the repo, or by asking once:
| Setting | How to resolve | Fallback |
|---|---|---|
| Annotation library | Handoff Annotation library field, or the AX library already published to the target Figma file |
Ask the user for the library name/URL |
| Component names | Inspect the library's component sets in the file | Order, Button, Image, Role Value Label, More info |
| Brand font | The font used by the library's text layers | Detect at runtime; see figma-tooling.md for the font-swap fallback |
| AX region | Handoff AX region, or the page/section holding the annotated screens |
Ask which section to annotate |
| Signed-off templates | Handoff template table | The user's most recently corrected screen |
If the library names components differently (for example Focus Order instead of Order), map them once and record the mapping in the handoff. Everything else in this skill stays the same.