accessibility-audit

Audits React components and pages against WCAG 2.1 AA criteria.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/robritacca-dotcom/design-system --skill accessibility-audit-robritacca-dotcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-audit
Source: https://github.com/robritacca-dotcom/design-system/tree/main/.claude/skills/accessibility-audit
Command: npx skills add https://github.com/robritacca-dotcom/design-system --skill accessibility-audit-robritacca-dotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automated axe checks already run in CI, but they miss colour contrast, meaningful alt text, focus order, and reduced-motion behavior. This Skill covers exactly those gaps with a structured manual audit of components and live pages. ## Core Features & Use Cases - Structural source audit: Reviews .tsx and .css files for semantic HTML, ARIA usage, keyboard navigation, focus styles, and motion handling, flagging only what axe cannot detect. - Visual contrast audit: Screenshots components in light and dark mode and computes foreground/background contrast ratios against WCAG 1.4.3 and 1.4.11 thresholds. - Severity-ranked reporting: Reports each finding with file, line, WCAG criterion, and a Critical/Moderate/Minor severity, plus a summary count. - Use Case: Ask whether the Dropdown component is accessible, and receive a line-level report distinguishing issues already enforced by the automated axe gate from genuine manual findings. ## Quick Start Run an accessibility audit on the Dropdown component and report any WCAG 2.1 AA violations with severity levels.

Frequently Asked Questions about accessibility-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a React component for WCAG accessibility?

Run the existing axe test gate first with npm run test, then audit the component's .tsx and .css source for semantic HTML, ARIA, keyboard handling, and focus styles. Finish with screenshots in both themes to check colour contrast ratios against WCAG 1.4.3 and 1.4.11.

What accessibility issues can axe not detect?

Axe catches roughly a third of WCAG issues. It cannot judge whether alt text is meaningful, whether focus order makes sense, whether helper messages are properly associated, or whether motion respects prefers-reduced-motion, so these require manual review.

Why is the color-contrast axe rule disabled in this project?

The rule is off by a settled decision because the action colour is a token consumers re-point to their own palettes, so the gate would judge a value the system does not own. Contrast checking is therefore the manual auditor's highest-priority job.

Does the audit cover reduced motion and animation accessibility?

Yes. It checks CSS motion through the reduced-motion block in tokens-motion.css and greps for prefers-reduced-motion in JavaScript-driven animations, since requestAnimationFrame loops are outside CSS guard coverage. Recharts charts rely on the isAnimationActive auto default.

Can I audit a live website page instead of a component?

Yes. The skill accepts a page URL and audits the live rendered page via screenshots in light and dark mode. A page-level axe pass already covers a route sample at desktop viewport, so full-site sweeps and mobile viewports remain manual work.