SkillsAdd

smithery.ai

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.

First seen Mar 20, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
azure-diagnostics Shared topics
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-validate Shared topics
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
azure-hosted-copilot-sdk Shared topics
microsoft/azure-skills 440.4K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,088 B
  • docs SUMMARY.md 465 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 5 installs

SKILL.md

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](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