Skip to content
UXClaim
Accessibility

Claude A11y Skill

Run comprehensive accessibility audits combining axe-core automated checks with jsx-a11y static analysis in a single command.

Claude A11y Skill gives Claude Code the ability to run accessibility audits against your project without leaving the terminal. It combines two complementary tools. axe-core handles runtime DOM analysis, catching issues that only surface in a rendered page. jsx-a11y performs static analysis on React components, flagging problems at the source level before they reach the browser.

How it works

Install the skill into your .claude/skills/ directory. When you invoke the audit command, Claude scans your project for component files, runs both analysis passes, and returns a consolidated report. Each finding includes the WCAG criterion it violates, the severity level, the affected element, and a suggested fix.

The skill groups findings by component rather than by rule. This means you can fix one file at a time without jumping between unrelated parts of the codebase.

When to reach for it

Use this skill during development to catch issues before they reach code review. It fits naturally into a TDD loop where you write a component, audit it, fix the findings, and move on. Teams that run it before every pull request report fewer accessibility regressions reaching production.

The skill is most useful on React and JSX-heavy projects. For plain HTML or server-rendered pages, a browser-based audit tool may be more appropriate.

Frequently asked questions

What's the difference between axe-core and jsx-a11y checks?
axe-core analyzes rendered DOM at runtime to catch issues that only appear in the browser, while jsx-a11y performs static analysis on React source code before it's rendered. Together they catch both code-level problems and runtime accessibility issues.
Can I use this skill on non-React projects?
The skill is optimized for React and JSX projects. For plain HTML or server-rendered pages, browser-based accessibility audit tools are typically more appropriate for your use case.
How do I install the Claude A11y Skill?
Run: git clone https://github.com/airowe/claude-a11y-skill.git ~/.claude/skills/a11y-skill. This installs the skill into your Claude Code environment for immediate use.
Does the skill report which WCAG standards are violated?
Yes. Each finding includes the specific WCAG criterion it violates, severity level, the affected element, and a suggested fix to help you address issues quickly.
How should I integrate accessibility audits into my workflow?
Run audits during development in a TDD loop: write component, audit it, fix findings, move on. Many teams run audits before every pull request to prevent accessibility regressions in production.
Are findings organized by rule or by component?
Findings are grouped by component, not by rule. This lets you fix one file at a time without jumping between unrelated parts of your codebase, making the workflow more efficient.
What information does each audit finding include?
Each finding shows the WCAG criterion violated, severity level, the specific affected element, and a suggested fix so you can address it immediately.

Glossary

axe-core
An automated accessibility testing engine that analyzes rendered DOM elements at runtime to detect WCAG violations that only surface when code is running in a browser.
jsx-a11y
A static analysis tool that scans React JSX source code before rendering to flag accessibility issues at the component definition level, catching problems early in development.
WCAG
Web Content Accessibility Guidelines, the international standard for web accessibility compliance that defines criteria for making digital content usable by everyone, including people with disabilities.
Static analysis
Automated code review that examines source files without running them, allowing accessibility problems to be detected before code is deployed or rendered in browsers.

More in Accessibility

All →
Accessibility

A&T Claude Skills

Reusable Claude Code skills for accessibility audits, WCAG compliance checking, and web development workflows

automateandtweak
Accessibility

a11y-skills

Claude Skills for accessibility auditing, code review, and WCAG 2.2 compliance across web, mobile, and documents.

joedevon