Find the regression, fix the source, prove the repair.
An open-source accessibility quality layer for teams building interfaces with
AI. Twelve portable Agent Skills guide coding agents through reproducible
evidence, conservative source fixes, scoped verification, and durable regression
tests. Framework-independent Playwright and axe-core packages provide the
deterministic core; React is the first tested framework fixture.
Tested accessibility skills, CLI, MCP server, and GitHub Action for agent-assisted audits and regression checks.
星标
11
工具
—
可用率
—
One complete workflow
Published core, CLI, and MCP packages support Node.js 20+. Run the CLI without
cloning the repository:
Review a fingerprint and its bounded DOM evidence, then ask:
Use fix-accessibility-issue to locate the source of this finding, make the
smallest supported repair, replay checkout-invalid, verify the fingerprint is
gone, and add the narrowest regression test.
The verification report records state reproduction, resolved and remaining
fingerprints, new serious/critical findings, and exact run IDs. The regression
test protects behavior such as an error being programmatically exposed—not
merely the presence of one attribute.
Install the skills
The canonical skills are the twelve directories under skills/; hosts should
use them directly.
From a local clone, install all twelve for Codex without prompts:
Codex: install the repository as a plugin, or copy skills/* into
~/.agents/skills/.
Claude Code: run /plugin marketplace add smukh/a11y-agent-skills, then
/plugin install a11y-agent-skills@a11y-agent-skills. You can also copy the
folders into .claude/skills/.
Cursor: use npx [email protected] add smukh/a11y-agent-skills and select
Cursor, or copy the folders into .cursor/skills/.
Data alternatives, filtering, chart interpretation, and equivalent tasks
For example: “Use accessible-combobox-and-autocomplete to review this city
selector, reproduce an out-of-order response, and protect the selected value
with a regression test.”
Each specialist includes a focused reference guide, standards links, manual
assistive-technology procedures, and paired behavioral fixtures. See the
specialist evaluation guide for runnable tests,
agent prompts, coverage limits, and negative controls. Browser assertions do not
prove screen-reader speech or task usability with every AT combination. See
release notes for version and packaging details.
Every evidence command supports JSON, Markdown, and SARIF. Scans support
explicit output, state, viewport, axe tags, include/exclude selectors,
Playwright storage state, request headers, failure thresholds, baselines,
readiness selectors, and reduced-motion emulation. Authentication inputs are not
serialized, and credential-shaped output is redacted. Reports still contain
bounded page evidence and must be handled as potentially sensitive artifacts.
Loopback URLs are treated as an explicit local target; other private networks
require --allow-private-network.
What this can determine
The tools can scan route-addressable states, wait for an observable readiness
selector, preserve deterministic engine findings, stabilize their fingerprints,
compare compatible runs, execute bounded keyboard journeys, and verify a defined
repair. They distinguish automated detection from heuristic inference and
required human review.
They cannot certify WCAG, decide whether content meaning is correct, replace
disabled participants, or represent every browser and assistive-technology
combination. axe-core is used because its maintained rule engine, metadata,
tests, and ecosystem should not be reimplemented here. The project preserves
axe-provided mappings and provenance without inventing standards relationships.
Automated and agent-assisted testing identifies a subset of accessibility
barriers. This result is not a declaration of WCAG conformance.
Chromium, Firefox, and WebKit are exposed by core through Playwright; CI
exercises Chromium. The browser layer is framework-independent. Source-location
guidance currently targets React conventions, but packages do not require a
framework. The repository is local-first, has no telemetry, needs no LLM or API
key, and does not auto-edit source or open pull requests.
A
A11y Agent Skills
smukh·11 个星标·
Tested accessibility skills, CLI, MCP server, and GitHub Action for agent-assisted audits and regression checks.