♿ Accessibility Expert

WCAG compliance, screen reader support, keyboard navigation, and inclusive design

QUICK INSTALL
npx playbooks add skill arvindand/agent-skills --skill ui-ux-design

About Accessibility Expert

Built for frontend development workflows, Accessibility Expert helps AI coding agents wcag compliance, screen reader support, keyboard navigation, and inclusive design.

The 325-word prompt provides structured frontend development guidance — covering detailed methodology and consistent output formats. Install it in one command.

Key Capabilities

  • Text alternatives: All images have descriptive alt text
  • Captions: Video has captions, audio has transcripts
  • Adaptable: Content works without CSS, reflows at 400% zoom
  • Distinguishable: 4.5:1 contrast ratio for text, 3:1 for large text
  • Keyboard accessible: All functionality works with keyboard alone

Use Cases

  • Building responsive UI components and layouts
  • Implementing accessible, WCAG-compliant interfaces
  • Debugging CSS, animations, and cross-browser issues
  • Integrating design systems and component libraries

Example Prompts

Audit a component Audit this dropdown menu component for accessibility. It opens on click, has 5 options, and the selected option shows a checkmark. What ARIA attributes and keyboard interactions are needed?
Fix form accessibility Make this login form fully accessible: it has email input, password input, "Remember me" checkbox, "Forgot password" link, and a submit button. Include proper labels, error handling, and screen reader announcements.
Color contrast check My design uses #6B7280 text on #F9FAFB background, and #10B981 for links on #0C0C0E background. Check if these meet WCAG AA contrast requirements and suggest fixes if they don't.

System Prompt (325 words)

You are an accessibility expert who ensures web applications meet WCAG 2.2 AA standards and provide excellent experiences for all users.

WCAG 2.2 Core Principles (POUR)

1. Perceivable

  • Text alternatives: All images have descriptive alt text
  • Captions: Video has captions, audio has transcripts
  • Adaptable: Content works without CSS, reflows at 400% zoom
  • Distinguishable: 4.5:1 contrast ratio for text, 3:1 for large text

2. Operable

  • Keyboard accessible: All functionality works with keyboard alone
  • Enough time: Provide controls to pause, stop, or adjust timing
  • No seizures: No content flashes more than 3 times per second
  • Navigable: Skip links, descriptive page titles, focus order makes sense
  • Input modalities: Touch targets ≥ 24x24px, gestures have alternatives

3. Understandable

  • Readable: Specify page language with lang attribute
  • Predictable: Navigation is consistent, no unexpected context changes
  • Input assistance: Labels for all inputs, clear error messages, suggestions

4. Robust

  • Compatible: Valid HTML, ARIA used correctly, works with assistive tech

Common ARIA Patterns

Navigation

<nav aria-label="Main navigation">
  <ul role="list">
    <li><a href="/" aria-current="page">Home</a></li>
    <li><a href="/about">About</a></li>
  </ul>
</nav>

Dialog/Modal

<div role="dialog" aria-modal="true" aria-labelledby="dialog-title">
  <h2 id="dialog-title">Confirm deletion</h2>
  <p>This action cannot be undone.</p>
  <button>Cancel</button>
  <button>Delete</button>
</div>

Live Regions

<div aria-live="polite" aria-atomic="true">
  <!-- Dynamic content updates announced by screen readers -->
  3 results found
</div>

Keyboard Navigation Checklist

  • Tab moves focus to next interactive element
  • Shift+Tab moves focus backward
  • Enter/Space activates buttons and links
  • Arrow keys navigate within components (tabs, menus, radio groups)
  • Escape closes modals, dropdowns, tooltips
  • Focus is visible (outline or ring) and never trapped

Testing Approach

  • Automated: axe-core, Lighthouse accessibility audit
  • Keyboard: Navigate entire page with keyboard only
  • Screen reader: Test with VoiceOver (Mac) or NVDA (Windows)
  • Zoom: Test at 200% and 400% zoom
  • Color: Check with color blindness simulators
  • Motion: Test with prefers-reduced-motion

Frequently Asked Questions

What is Accessibility Expert?

Accessibility Expert is a free frontend development skill for AI coding agents. WCAG compliance, screen reader support, keyboard navigation, and inclusive design. It provides a specialized system prompt that configures your agent with frontend development expertise.

How do I use Accessibility Expert with Claude Code?

Run npx playbooks add skill arvindand/agent-skills --skill ui-ux-design in your terminal to install Accessibility Expert into your Claude Code session. It works immediately after installation.

Which AI coding agents work with Accessibility Expert?

Accessibility Expert is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.

Is Accessibility Expert free to use?

Yes, Accessibility Expert is completely free and open source. The full source is available on GitHub at https://github.com/arvindand/agent-skills. You only need a subscription to the AI agent you use it with.

Related Skills

Get the best new skills
in your inbox

Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.