a11y-knowledge
Accessibility Knowledge Base
A reference knowledge base that collects, per success criterion, "what the judgment is based on". It does not restate the definitions of WCAG success criteria or the ARIA specification (the agent is assumed to know them). What it does write down is: which parts of the Understanding documents to hold onto, the judgment lines for interpretation, how to build so the judgment lines are met, and what automated checks can and cannot decide.
This skill does not do work on its own. The implementation, review, and audit skills use it to read only the files for the success criteria they need.
How to look things up
- When you know the success criterion number: read
references/criteria/<number>.md(for examplereferences/criteria/1.1.1.md). The list is in references/index-by-criterion.md. - When searching by component type (when writing or reviewing code): use references/index-by-component.md to find, from the component (button, link, image, dialog, and so on), the success criteria that apply to it, then read each file.
- When reading the results of automated checks (axe,
@a11y-skills/audit): use references/checks-axe.md and references/checks-audit.md to confirm which results are settled and which need review, then read "When checking" in each success criterion's file. - Success criteria that compare multiple pages (3.2.3 / 3.2.4 / 3.2.6, and the comparison for 2.4.2): first read the shared judgment rules in references/cross-page.md.
Do not read everything at once. Read only the success criteria being asked about.
When editing references, read Editing and checking judgment evidence. 2.5.8 / 1.1.1 / 4.1.2 / 2.4.3 / 2.4.7 / 2.4.11 / 1.4.11 / 2.4.12 / 2.4.13 / 1.4.4 / 1.4.10 / 1.4.12 / 2.5.1 / 2.5.7 / 2.5.5 / 2.1.4 / 2.5.2 / 2.5.4 / 1.3.3 / 1.3.4 / 1.4.1 / 2.2.1 / 2.2.2 / 1.4.2 / 3.3.1 / 3.3.2 / 3.3.3 / 3.2.3 / 3.2.4 / 3.2.6 / 2.4.1 / 2.4.2 / 2.4.4 / 1.3.1 / 1.3.5 / 3.1.1 / 2.1.1 / 3.2.1 / 3.3.4 / 1.2.2 / 1.4.5 / 1.2.1 / 1.2.3 / 1.2.5 / 2.1.2 / 1.4.13 / 3.2.2 / 2.5.3 / 2.4.6 / 4.1.3 / 3.3.7 / 3.3.8 / 1.3.2 / 3.1.2 / 2.4.5 use the pilot format with evidence IDs. Read each item’s source type, conditions, and limits and follow IDs from judgment lines. Verification covers the documented scope, not all cases or criteria without files.