accessibility-generallisted
Install: claude install-skill mgifford/accessibility-skills
# ACCESSIBILITY.md Agent Skill
This skill teaches AI coding agents how to use the ACCESSIBILITY.md framework,
including when to load topic-specific skills, how to apply examples, and what
the project's non-negotiable requirements are.
> **Scope**: Apply this skill whenever working in any project that has an
> `ACCESSIBILITY.md` file at its root, or when contributing to the
> `mgifford/ACCESSIBILITY.md` repository itself.
---
## What ACCESSIBILITY.md Is
`ACCESSIBILITY.md` is a documentation standard — a predictable, machine-readable
place to find a project's:
* Conformance target (e.g., WCAG 2.2 AA)
* CI/automated guardrails
* Assistive technology coverage
* Known gaps and open issues
* Definition of Done for accessibility
Read `ACCESSIBILITY.md` before proposing or writing changes to any project that
has one. It is the source of truth for that project's accessibility requirements.
---
## Topic Skills: When to Load Them
This repo ships per-topic skills in `skills/`. Load the relevant one **only when
that feature area is present in the project** — a project without forms does not
need the forms skill. Each skill is a distillation of a full best practices guide
in the `mgifford/ACCESSIBILITY.md` `examples/` directory.
| When the project includes… | Load skill |
| --- | --- |
| Color themes, dark/light mode | `skills/light-dark-mode/SKILL.md` |
| Forms, inputs, validation | `skills/forms/SKILL.md` *(if forms are present)* |
| SVG graphics | `skills/svg/SKILL.md` *(if S