How do I install the Accessibility Audit skill?

Run npx skillmds add majiayu000/accessibility-audit-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Accessibility Audit safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Accessibility Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Accessibility Audit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Accessibility Audit?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Accessibility Audit by majiayu000 — Agent Skill

Name: Accessibility Audit
Rating: 4.2 (5 reviews)
Author: majiayu000

Accessibility Audit

Use PROACTIVELY when user asks for accessibility review, a11y audit, WCAG compliance check, screen reader testing, keyboard navigation validation, or color contrast analysis. Audits React/TypeScript applications for WCAG 2.2 Level AA compliance with risk-based severity scoring. Includes MUI framework awareness to avoid false positives. Not for runtime accessibility testing in production, automated remediation, or non-React frameworks.

majiayu000 c78e039 2 files · 3.5 KB Updated Sep 9, 2026 567 repo stars

File contents

Accessibility Audit Skill

Comprehensive WCAG 2.2 Level AA accessibility auditing for React/TypeScript applications with MUI framework awareness.

Quick Reference

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

Key Principle

Severity = Impact x Likelihood, NOT WCAG conformance level. A Level A failure can be LOW severity; a Level AA failure can be CRITICAL.

Required Tooling

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

# Configure ESLint
# Add to .eslintrc: extends: ['plugin:jsx-a11y/recommended']

Workflow

Phase	Description
1. Setup	Install tooling, create output directories
2. Static Analysis	ESLint jsx-a11y scan
3. Runtime Analysis	jest-axe and Playwright
4. Manual Validation	Keyboard, screen reader, contrast
5. Report Generation	JSON + Markdown outputs

Phase 1: Setup

See workflow/setup.md for installation and configuration.

Phase 4: Manual Validation

See workflow/manual-validation.md for keyboard and screen reader testing.

Reference

Severity Rubric - Impact x Likelihood calculation
MUI Framework Awareness - Built-in accessibility features

Common False Positives to Avoid

Component	Built-in Behavior	Don't Flag
MUI `<SvgIcon>`	Auto `aria-hidden="true"`	Icons without titleAccess
MUI `<Alert>`	Default `role="alert"`	Missing role attribute
MUI `<Button>`	36.5px min height	Target size < 44px
MUI `<TextField>`	Auto label association	Missing label
MUI `<Autocomplete>`	Manages ARIA attrs	Missing aria-expanded

Quick Audit Command

Run accessibility audit on [component/page] following WCAG 2.2 AA standards

Related Skills

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

---name: accessibility-audit-3description: Use PROACTIVELY when user asks for accessibility review, a11y audit, WCAG compliance check, screen reader testing, keyboard navigation validation, or color contrast analysis. Audits React/TypeScript applications for WCAG 2.2 Level AA compliance with risk-based severity scoring. Includes MUI framework awareness to avoid false positives. Not for runtime accessibility testing in production, automated remediation, or non-React frameworks.--- # Accessibility Audit Skill Comprehensive WCAG 2.2 Level AA accessibility auditing for React/TypeScript applications with MUI framework awareness. ## Quick Reference | Severity | Impact | Examples | |----------|--------|----------| | **Critical** | Blocks access completely | Keyboard traps, missing alt on actions, no focus visible | | **High** | Significantly degrades UX | Poor contrast on CTAs, no skip navigation, small touch targets | | **Medium** | Minor usability impact | Missing autocomplete, unclear link text | | **Low** | Best practice enhancement | Could add tooltips, more descriptive titles | ## Key Principle > **Severity = Impact x Likelihood**, NOT WCAG conformance level. > A Level A failure can be LOW severity; a Level AA failure can be CRITICAL. ## Required Tooling ```bash # Install required tools npm install --save-dev eslint-plugin-jsx-a11y jest-axe @axe-core/playwright # Configure ESLint # Add to .eslintrc: extends: ['plugin:jsx-a11y/recommended'] ``` ## Workflow | Phase | Description | |-------|-------------| | 1. Setup | Install tooling, create output directories | | 2. Static Analysis | ESLint jsx-a11y scan | | 3. Runtime Analysis | jest-axe and Playwright | | 4. Manual Validation | Keyboard, screen reader, contrast | | 5. Report Generation | JSON + Markdown outputs | ### Phase 1: Setup See [workflow/setup.md](workflow/setup.md) for installation and configuration. ### Phase 4: Manual Validation See [workflow/manual-validation.md](workflow/manual-validation.md) for keyboard and screen reader testing. ## Reference - [Severity Rubric](reference/severity-rubric.md) - Impact x Likelihood calculation - [MUI Framework Awareness](reference/mui-awareness.md) - Built-in accessibility features ## Common False Positives to Avoid | Component | Built-in Behavior | Don't Flag | |-----------|-------------------|------------| | MUI `<SvgIcon>` | Auto `aria-hidden="true"` | Icons without titleAccess | | MUI `<Alert>` | Default `role="alert"` | Missing role attribute | | MUI `<Button>` | 36.5px min height | Target size < 44px | | MUI `<TextField>` | Auto label association | Missing label | | MUI `<Autocomplete>` | Manages ARIA attrs | Missing aria-expanded | ## Quick Audit Command ``` Run accessibility audit on [component/page] following WCAG 2.2 AA standards ``` ## Related Skills - `codebase-auditor` - General code quality analysis - `bulletproof-react-auditor` - React architecture review

Frequently asked questions