Accessibility Audit

WCAG 2.2 Level AA accessibility auditing with risk-based severity scoring for React/TypeScript applications.

Overview

This skill provides comprehensive accessibility auditing that goes beyond simple WCAG conformance checking. It uses a risk-based severity model where Severity = Impact x Likelihood, meaning a Level A failure can be LOW severity while a Level AA failure can be CRITICAL.

Key Features

Risk-based severity scoring - Prioritizes issues by real user impact
MUI framework awareness - Avoids false positives on built-in accessibility features
Multi-layer analysis - Static (ESLint), runtime (jest-axe, Playwright), and manual validation
Actionable output - Gap reports with remediation priorities

Quick Start

# Install required tooling
npm install --save-dev eslint-plugin-jsx-a11y jest-axe @axe-core/playwright

# Run audit
# Use trigger: "Run accessibility audit on [component/page]"

Trigger Phrases

"accessibility audit"
"WCAG compliance"
"a11y review"
"screen reader"
"keyboard navigation"
"color contrast"

Severity Levels

Severity	Impact	Examples
Critical	Blocks access	Keyboard traps, missing alt on actions
High	Significantly degrades UX	Poor contrast on CTAs, no skip navigation
Medium	Minor usability impact	Missing autocomplete, unclear link text
Low	Best practice	Could add tooltips, more descriptive titles

codebase-auditor - General code quality analysis
bulletproof-react-auditor - React architecture review

Documentation

See SKILL.md for the complete workflow and reference materials.

1.7 KiB Raw Blame History