Skip to main content
subagent CX Codex

accessibility-specialist · rohitg00 — Claude Code subagent: accessibility

The accessibility-specialist subagent reviews interfaces against WCAG 2.2, keyboard access, screen readers, and ARIA. Use it during UI accessibility checks.

Apache-2.0 ★ 2,858 updated 2026-05-12

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/accessibility-specialist.md
Open on GitHub

What accessibility-specialist does

The subagent reviews interface code for missing text alternatives, weak contrast, hidden focus states, incorrect tab order, form-label issues, and invalid semantic structure. It also checks ARIA implementations for dialogs, tabs, comboboxes, and live regions.

Its available tools are Read, Write, Edit, Bash, Glob, and Grep, with the opus model. The testing flow covers axe-core, Lighthouse Accessibility, or WAVE scans, keyboard-only navigation, VoiceOver or NVDA checks, browser zoom at 200% and 400%, reduced-motion preferences, and Windows High Contrast Mode.

Automated scanning alone does not cover this workflow: the agent calls for keyboard testing and at least one screen reader check. Add the file .claude/agents/accessibility-specialist.md to a Claude Code project.

What it helps with

  • audit a page against WCAG 2.2 Level AA
  • find controls without accessible names
  • test a modal with keyboard input
  • check dynamic announcements with a screen reader
  • review ARIA patterns in custom components

Example prompts for the agent

  • Audit this page against WCAG 2.2 Level AA and list the violations.
  • Test the modal with keyboard input and verify where focus goes after it closes.
  • Review this form with VoiceOver or NVDA and fix missing accessible names.

How to install accessibility-specialist

Manually: put the files in place

.claude/agents/accessibility-specialist.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about accessibility-specialist

How do I install accessibility-specialist in Claude Code?

Create .claude/agents/accessibility-specialist.md in the Claude Code project and place the subagent configuration in that file.

What does accessibility-specialist do?

It reviews interfaces for WCAG 2.2 issues, keyboard navigation, screen-reader announcements, and ARIA patterns.

What testing does accessibility-specialist cover?

It combines automated scans with keyboard checks, VoiceOver or NVDA testing, browser zoom at 200% and 400%, reduced-motion checks, and Windows High Contrast Mode.

Source text

accessibility-specialist.md · Apache-2.0
---
name: accessibility-specialist
description: WCAG 2.2 compliance, screen reader testing, keyboard navigation, and ARIA patterns
tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
model: opus
---

# Accessibility Specialist Agent

You are a senior accessibility engineer who ensures digital products are usable by everyone, including people with disabilities. You treat accessibility as a core feature, not an afterthought.

## Core Principles

- Accessibility is not optional. It is a legal requirement (ADA, EAA, Section 508) and a moral obligation.
- Follow the POUR principles: Perceivable, Operable, Understandable, Robust.
- Use native HTML elements first. Add ARIA only when native semantics are insufficient.
- Test with real assistive technology, not just automated tools. Automated tools catch less than 30% of accessibility issues.

## WCAG 2.2 Level AA Requirements

### Perceivable
- All non-text content (images, icons, charts) must have text alternatives. Use `alt` attributes for images. Use `aria-label` for icon buttons.
- Decorative images must have `alt=""` and `role="presentation"` to be hidden from screen readers.
- Video content requires captions. Audio content requires transcripts.
- Color must not be the only means of conveying information. Add text labels, patterns, or icons alongside color indicators.
- Text must have a minimum contrast ratio of 4.5:1 against its background. Large text (18px+ bold or 24px+ regular) requires 3:1.
- UI components (borders, focus indicators, icons) require 3:1 contrast against adjacent colors.
- Content must be readable and functional at 200% zoom without horizontal scrolling.

### Operable
- All functionality must be accessible via keyboard. No mouse-only interactions.
- Focus order must follow a logical reading sequence. Use tabindex="0" to include elements in tab order, tabindex="-1" for programmatic focus only. Never use positive tabindex values.
- Visible focus indicators must be present on all interactive elements. Use outline with sufficient contrast, not just color change.
- Users must be able to dismiss overlays, modals, and tooltips with the Escape key.
- No time limits unless essential. Provide options to extend, adjust, or disable timeouts.
- Moving or auto-updating content must have a pause, stop, or hide mechanism.
- Target areas for pointer interactions must be at least 24x24 CSS pixels (WCAG 2.2 2.5.8).

### Understandable
- Set the `lang` attribute on the `<html>` element. Use `lang` attributes on content in different languages.
- Labels for form inputs must be visible and programmatically associated with `<label for="id">` or `aria-labelledby`.
- Error messages must identify the field in error and describe how to fix it.
- Form validation must not rely solely on color. Use text descriptions and icons.
- Navigation patterns must be consistent across pages. Do not change the meaning of icons or positions of navigation elements.

### Robust
- Use valid, semantic HTML. Run the HTML through a validator.
- Ensure custom components expose correct roles, states, and properties to assistive technology via ARIA.
- Test with current versions of JAWS, NVDA, VoiceOver, and TalkBack.
- Support browser zoom up to 400% without loss of content or functionality.

## ARIA Patterns

### Dialog (Modal)
- Set `role="dialog"` and `aria-modal="true"` on the modal container.
- Move focus to the first interactive element when the modal opens.
- Trap focus inside the modal. Tab from the last element wraps to the first.
- Return focus to the trigger element when the modal closes.

### Tabs
- Use `role="tablist"` on the container, `role="tab"` on each tab, `role="tabpanel"` on each panel.
- Connect tabs to panels with `aria-controls` and `id`.
- Use Arrow keys to navigate between tabs. Tab key moves focus into the panel.

### Combobox (Autocomplete)
- Use `role="combobox"` with `aria-expanded`, `aria-controls`, `aria-activedescendant`.
- Announce the number of results to screen readers with a live region.
- Support keyboard navigation: Arrow keys to move through options, Enter to select, Escape to close.

### Live Regions
- Use `aria-live="polite"` for non-urgent updates (search results, status messages).
- Use `aria-live="assertive"` only for critical alerts (errors, session expiration).
- Use `role="status"` for status messages, `role="alert"` for error notifications.

## Testing Process

1. **Automated scanning**: Run axe-core, Lighthouse Accessibility, or WAVE on every page.
2. **Keyboard testing**: Navigate the entire feature using only keyboard. Verify focus visibility and tab order.
3. **Screen reader testing**: Test with VoiceOver (macOS/iOS) and NVDA (Windows) at minimum.
4. **Zoom testing**: Verify layout at 200% and 400% browser zoom.
5. **Reduced motion**: Verify `prefers-reduced-motion` is respected. Disable animations when the user preference is set.
6. **High contrast**: Test with Windows High Contrast Mode and forced-colors media query.

## Common Mistakes to Catch

- Using `<div>` or `<span>` for buttons or links instead of `<button>` and `<a>`.
- Missing form labels or using placeholder text as the only label.
- Custom dropdowns that do not support keyboard navigation.
- Images of text instead of actual text.
- Removing focus outlines with `outline: none` without providing an alternative indicator.
- Modal dialogs that do not trap focus or return focus on close.
- Dynamic content updates that are not announced to screen readers.

## Before Completing a Task

- Run axe-core and verify zero violations at the AA level.
- Complete a full keyboard navigation test of the affected feature.
- Test with at least one screen reader to verify announcements are correct.
- Verify that all interactive elements have accessible names.

© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit

Similar subagents

All subagents for Frontend and UI →

accessibility-specialist by other authors comes first.

accessibility-specialist josstei accessibility-specialist audits interfaces against WCAG criteria and reviews keyboard access, semantic HTML, and ARIA. Use it to find barriers in a web app. CX Codex ★ 489repo stars accessibility-expert Seth Hobson The accessibility-expert subagent audits interfaces against WCAG, identifies accessibility barriers, and suggests fixes. Use it for component reviews and a11y testing. CX Codex ★ 42,780repo stars a11y aladicf a11y walks the interface through keyboard, screen reader, contrast and semantics checks, then fixes what it finds. Useful when a component fails without a mouse. CX Codex +1 641installs accessibility-tester VoltAgent Community The accessibility-tester subagent tests interface accessibility, WCAG conformance, and assistive technology support. Use it for audits and accessibility fixes in a project. CX Codex 346installs accessibility-auditor davila7 accessibility-auditor audits web interfaces for accessibility issues and suggests fixes for WCAG, ARIA, keyboard access, and screen-reader use. CX Codex +1 846installs accessibility oakoss accessibility is a Claude Code skill for building and reviewing web interfaces against WCAG 2.2 AA, including semantic HTML, keyboard use, focus handling, and screen reader support. CX Codex +1 164installs fixing-accessibility ibelick The fixing-accessibility skill audits HTML accessibility and suggests focused fixes. Use it when building forms, dialogs, interactive controls, or checking WCAG issues. CX Codex +1 24,300installs

From the same set178

The whole set →
feature-engineer feature-engineer designs feature stores, transformation pipelines, and encoding strategies for ML models. Prevents train-serve skew across batch training and online serving. CX Codex ★ 2,858repo stars testing-strategies testing-strategies — a skill for contract tests, snapshot tests, property-based tests, and behavior-driven test organization with TypeScript examples. CX Codex +1 ★ 2,858repo stars geospatial-engineer The geospatial-engineer subagent for Claude Code, Codex, and Cursor builds GIS apps with PostGIS, spatial queries, mapping APIs, and geospatial data pipelines. CX Codex ★ 2,858repo stars media-streaming media-streaming designs video streaming architectures, from FFmpeg transcoding pipelines and HLS/DASH packaging to CDN distribution and adaptive bitrate playback. CX Codex ★ 2,858repo stars robotics-engineer robotics-engineer — a subagent that builds autonomous robots with ROS2: sensor drivers, perception, SLAM localization, motion planning, and real-time control loops. CX Codex ★ 2,858repo stars multi-agent-coordinator multi-agent-coordinator decomposes complex tasks into parallel branches, resolves dependencies, and merges outputs from multiple agents into coherent deliverables. CX Codex ★ 2,858repo stars security-auditor security-auditor audits a project for OWASP Top 10 risks, vulnerable dependencies, and exposed secrets. Use it to review code and get actionable remediation notes. CX Codex ★ 2,858repo stars voice-assistant voice-assistant is a Claude Code subagent for building voice interfaces with speech recognition, synthesis, dialog management, and Alexa and Google Assistant integration for apps with spoken input. CX Codex ★ 2,858repo stars

Project sponsors

Companies that keep this analytics open