accessibility-review

Audit design system tokens and components for WCAG compliance.

Updated Sep 14, 2025
One-click install
npx skills add https://github.com/Higashi-Kota/react-tailwindcss-sandbox --skill accessibility-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-review
Source: https://github.com/Higashi-Kota/react-tailwindcss-sandbox/tree/main/.claude/skills/accessibility-review
Command: npx skills add https://github.com/Higashi-Kota/react-tailwindcss-sandbox --skill accessibility-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pnpm.

What problem does it solve?

Lack of accessibility compliance (WCAG 2.1 AA/AAA) can exclude users, lead to legal issues, and degrade user experience. This Skill conducts a thorough audit of your design system's accessibility, identifying critical issues and providing actionable fixes to build a more inclusive UI.

Core Features & Use Cases

  • Contrast Ratio Validation: Checks text and UI component contrast against WCAG AA/AAA and APCA standards, flagging insufficient contrast.
  • State Differentiation: Verifies that interactive states (e.g., base, hover, focus) have distinct visual feedback, preventing confusion.
  • Dark Mode Rules: Ensures hover states are darker in dark mode and text adapts correctly to maintain readability.
  • Focus Management: Reviews focus indicator visibility, focus trap implementation in overlays, and keyboard navigation.
  • Token Architecture Analysis: Evaluates color token structure for accessibility best practices, identifying potential systemic issues.
  • Use Case: Audit all interactive components in your design system to ensure they meet WCAG AA contrast requirements, have visible focus indicators, and correctly differentiate states for keyboard and mouse users.

Quick Start

Use the accessibility-review skill for a complete WCAG compliance audit of the entire design system.

Frequently Asked Questions about accessibility-review

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

FAQPage Schema
How do I audit my design system for WCAG compliance?

WCAG compliance auditing checks your design tokens and UI components against accessibility standards (AA/AAA). This Skill automatically validates contrast ratios, state differentiation, focus indicators, and keyboard navigation across your design system, then reports prioritized findings with actionable remediation steps.

What does contrast ratio validation do for accessibility?

Contrast ratio validation ensures text and UI components meet WCAG AA/AAA standards and APCA calculations for readability. The Skill flags insufficient contrast between foreground and background colors, helping you identify which tokens and components need adjustment for inclusive design.

Can I check dark mode contrast separately from light mode?

Yes. Dark mode contrast rules ensure hover states are darker in dark mode and text adapts correctly for readability. The Skill evaluates contrast requirements independently for light and dark theme tokens, validating state differentiation in each context.

How do I ensure keyboard navigation and focus indicators work correctly?

Focus management review checks focus indicator visibility, focus trap implementation in overlays, and keyboard navigation paths. The Skill audits your components' focus states and validates that interactive elements are reachable and distinguishable via keyboard alone.

What file formats does the accessibility-review Skill work with?

The Skill analyzes YAML token files (packages/theme/docs/design-tokens.yml) and component source code (packages/ui/src/components). It evaluates color token architecture and UI code for accessibility issues, producing a structured report with token/state mappings and executive summary.

Do I need a specific tool to run accessibility audits on my design system?

The Skill requires pnpm as a dependency for package management. Beyond that, it operates on your existing design token files and component code without additional tool setup, making it accessible to teams already using standard design system workflows.