a11y-core
Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules. Read by skills, never dispatched…
Reference data, not a reviewer. Review UI for cognitive load, plain language clarity, and WCAG 2.2 cognitive SC (3.3.7, 3.3.8, 3.3.9). Includes COGA guidance, reading level, auth patterns, and timeout warnings.
Claude Code
$ npx -y skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility --agent claude-code
Codex
$ npx skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility -a codex -y
Cursor
$ npx skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility -a cursor -y
Gemini CLI
$ npx skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility -a gemini-cli -y
GitHub Copilot
$ npx skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility -a github-copilot -y
OpenCode
$ npx skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility -a opencode -y
Windsurf
$ npx skills add Community-Access/accessibility-agents --skill kb-cognitive-accessibility -a windsurf -y
name: kb-cognitive-accessibility description: Reference data, not a reviewer. Review UI for cognitive load, plain language clarity, and WCAG 2.2 cognitive SC (3.3.7, 3.3.8, 3.3.9). Includes COGA guidance, reading level, auth patterns, and timeout warnings. license: MIT disable-model-invocation: true user-invocable: false metadata: tier: reference domain: cross-cutting output: none effort: low title: Cognitive Accessibility
**Domain:** Cognitive, learning, and neurological accessibility **WCAG scope:** WCAG 2.2 AA + key AAA, COGA W3C guidance **Agents that use this skill:** `cognitive-accessibility`, `web-accessibility-wizard`, `accessibility-lead`, `forms-specialist`
---
This skill provides reference tables, scoring formulas, and evaluation patterns for cognitive accessibility review. It covers:
---
Each SC, with name, what to check and common failures.
| SC | Name | What to Check | Common Failures | |----|------|--------------|-----------------| | 2.2.1 | Timing Adjustable | Session timeouts warn >=20s before expiry; user can extend >=10x or disable | Redirect without warning; extension UI exists but does nothing | | 2.2.2 | Pause, Stop, Hide | Auto-moving/blinking content >5s has pause/stop control | Blinking backgrounds, marquee text, auto-scrolling feeds | | 2.3.1 | Three Flashes or Below Threshold | No more than three flashes in any one-second period, unless below the general and red flash thresholds | Transition animations that strobe | | 3.3.1 | Error Identification | Error identified in text, not just color | Red border with no error message | | 3.3.2 | Labels or Instructions | Format requirements shown *before* error, required fields identified upfront | Format hint only in error state; asterisks with no legend | | 3.3.7 | Redundant Entry *(2.2 new)* | Previously-entered info not re-requested in same session unless security-essential or stale | Email re-entered on step 3; billing address not pre-filled from shipping |
Each SC, with name, what to check and common failures.
| SC | Name | What to Check | Common Failures | |----|------|--------------|-----------------| | 2.4.6 | Headings and Labels | Headings describe content; labels describe input purpose | "Section 1", "Info", "Details" as heading text | | 3.2.3 | Consistent Navigation | Nav appears in same relative order across pages | Footer nav changes order on mobile vs desktop | | 3.2.4 | Consistent Identification | Same-function components have same accessible name across pages | "Search" button on one page, "Find" on another | | 3.3.3 | Error Suggestion | For detected errors, suggest correction when possible/safe | "Invalid email" with no example or format hint | | 3.3.4 | Error Prevention (Legal, Financial, Data) | Review step before irreversible submission; allow reversal or confirmation | One-click purchase with no review screen; no undo for account deletion | | 3.3.8 | Accessible Authentication Min. *(2.2 new)* | Authentication must not require cognitive function test unless an alternative or exception (object recognition, personal content) applies | Password managers actively blocked from filling login fields; paste disabled in password fields; transcription-only CAPTCHA, including audio CAPTCHA |
Each SC, with name and what to check.
| SC | Name | What to Check | |----|------|--------------| | 2.2.6 | Timeouts | Warn about data loss from inactivity at start of session | | 3.1.3 | Unusual Words | Jargon/idiom defined on first use | | 3.1.4 | Abbreviations | Abbreviations expanded on first use | | 3.1.5 | Reading Level | Text above lower secondary education level has supplemental content or a simpler version (grade 8 is a working proxy); see formula below | | 3.3.9 | Accessible Authentication Enhanced *(2.2 new)* | No cognitive function test unless an alternative exists (removes the object-recognition and personal-content exceptions) |
---
Each pattern, with its failure and SC.
| Pattern | Failure | SC | |---------|---------|-----| | Script or attributes that actively stop password managers filling `type="password"` | Forces recall or transcription | 3.3.8 | | JavaScript `onpaste="return false"` on password input | Blocks manual paste | 3.3.8 | | CAPTCHA with only distorted text option | No cognitive-free alternative | 3.3.8 | | Security question requiring exact recall | Pure memory test | 3.3.8 | | Re-entering full card number on the same session order flow | Redundant cognitive work | 3.3.7 |
Each pattern, with why it passes.
| Pattern | Why It Passes | |---------|--------------| | `<input type="password" autocomplete="current-password">` | Allows password manager autofill | | Passkey/biometric as login alternative | No cognitive function test | | "Same as shipping address" checkbox on billing form | Eliminates redundant entry | | CAPTCHA with a non-cognitive alternative, or (AA only) an object-recognition CAPTCHA | Meets the alternative or object-recognition exception; an audio CAPTCHA that must be transcribed does not | | Email magic link with no password required | Removes cognitive test entirely |
---
In multi-step forms or wizards:
1. Map all input fields across all steps 2. Flag any field that requests information already collected in an earlier step 3. Exception: security confirmation (password confirm) and data that can become stale
WCAG 2.2 AA enforcement for agentic coding, as a set of Agent Skills. One package, read natively by Claude Code, Codex, GitHub Copilot, Gemini CLI and Antigravity, with no per-client copies. Models forget accessibility while generating code.
Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules. Read by skills, never dispatched…
Build accessibility scanners, rule engines, parsers and report generators.
Web UI accessibility lead. Use before writing or changing HTML, JSX, TSX, Vue, Svelte, CSS or templates. Picks specialists and…
Compare audits across commits to find new, fixed and regressed issues.
Generate a W3C or EU model accessibility statement from audit results.
GitHub Actions: workflow runs, logs, re-runs and CI failure triage.
Produce the "Playwright 1.xx API Review" artifact for a range of commits - the public API additions and the breaking or behavior…
Write, refine, run, and QA promptfoo evaluation suites: promptfooconfig.yaml, prompts, providers, vars, tests, assertions,…
DeepEval evaluation workflow for AI agents and LLM applications. TRIGGER when the user wants to evaluate or improve an AI agent,…