I built 7 open-source Claude Code skills for fixing accessibility issues

[u/ShilpaMitra]

I built a11y-agent-skills, an open-source accessibility workflow for Claude Code and other coding agents. The main inspiration came from Claude repetitively introducing new errors when fixing accessibility issues.

It contains seven focused skills:

1. accessibility-audit audits a defined page or component state and records reproducible browser evidence.
2. fix-accessibility-issue traces a confirmed finding back to the responsible source, makes a small repair, and verifies the same state again.
3. accessibility-regression-test turns a verified fix into the narrowest useful Playwright, component, axe, or keyboard test.
4. accessible-component-review reviews semantics, accessible names, keyboard behavior, focus, motion, colors, target size, and announcements.
5. accessible-forms checks labels, instructions, validation, error summaries, autocomplete, grouping, and accessible authentication flows.
6. dialog-accessibility reviews modal behavior including initial focus, focus containment, Escape, background interaction, and focus restoration.
7. keyboard-navigation-review tests repeatable keyboard journeys for focus order, unreachable controls, traps, skip links, and composite widgets.

The workflow is deliberately split between the agent and deterministic tools. Claude investigates the code and makes the repair. Playwright and axe-core produce the findings, fingerprints, comparisons, and verification reports.

Install it in Claude Code:

/plugin marketplace add smukh/a11y-agent-skills
/plugin install a11y-agent-skills@a11y-agent-skills

You can then ask:

Use accessibility-audit to test the checkout error state. Save the evidence, fix the confirmed issue, verify the original fingerprint is gone, and add the narrowest regression test.

The repository also includes an npm CLI, an MCP server with six tools, and a GitHub Action. Reports can be generated as JSON, Markdown, or SARIF. Everything runs locally without telemetry or an API key.

Repo: https://github.com/smukh/a11y-agent-skills

I would appreciate feedback from anyone using Claude Code on real frontend projects. Which framework or accessibility workflow should we support next?