a11y-expert

Audit web UI semantics and interactions against WCAG 2.2 AA.

Updated May 3, 2026
One-click install
npx skills add https://github.com/david-nossebro/agent-commons --skill a11y-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a11y-expert
Source: https://github.com/david-nossebro/agent-commons/tree/main/shared/skills/a11y-expert
Command: npx skills add https://github.com/david-nossebro/agent-commons --skill a11y-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps teams research, audit, and fix web accessibility issues so UI is usable for keyboard, screen reader, low-vision, cognitive, and motion-sensitive users with a WCAG 2.2 AA baseline.

Core Features & Use Cases

  • Standards-grounded audits and remediation: Identifies issues first by user impact and maps fixes to relevant WCAG 2.2 AA considerations.
  • Implementation-ready guidance: Provides concrete, engineering-focused changes for semantics, focus management, labels, keyboard interaction, ARIA usage, and error handling.
  • Practical verification workflow: Combines automated checks with manual keyboard walkthroughs, focus order/visibility review, screen-reader-oriented naming checks, zoom/reflow spot checks, and reduced-motion/contrast validation.
  • Component and pattern support: Reviews or guides interactive components like dialogs, menus, tabs, accordions, custom selects, and form controls to ensure correct accessible names, roles, and states.
  • ARIA used carefully: Prioritizes native HTML patterns and uses ARIA only when native semantics are insufficient, avoiding patching broken structure.

Quick Start

Use a11y-expert to audit and fix the accessibility of the provided web UI for WCAG 2.2 AA by reporting prioritized issues with user impact and proposing concrete code-level remediation plus a concise testing checklist.

Frequently Asked Questions about a11y-expert

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

FAQPage Schema
How do I audit my web UI for WCAG 2.2 AA compliance?

To audit web UI for WCAG 2.2 AA compliance, you review UI semantics, keyboard behavior, focus management, labeling, ARIA usage, and user-impacted states against baseline criteria. This produces actionable findings separating automation from human judgment, including concrete remediation and verification steps.

What is the best way to fix keyboard navigation and focus management issues?

Fixing keyboard navigation and focus management requires prioritizing native HTML patterns and using ARIA only when native semantics are insufficient. You provide concrete, engineering-focused changes for focus order, visibility, and keyboard interaction to ensure correct accessible names, roles, and states.

How do I implement accessible form validation and error handling?

Implementing accessible form validation involves engineering-focused changes for semantics, labels, and error handling mapped to WCAG 2.2 AA considerations. You identify issues by user impact first, then apply concrete code-level remediation to ensure forms are usable for keyboard and screen reader users.

When do I need ARIA attributes for custom interactive components like dialogs and menus?

You need ARIA attributes for custom interactive components like dialogs, menus, tabs, and accordions only when native HTML semantics are insufficient. Prioritize native HTML patterns to avoid patching broken structure, ensuring correct accessible names, roles, and states for screen reader users.

How do I verify web accessibility fixes for screen reader and low-vision users?

Verify web accessibility fixes by combining automated checks with manual keyboard walkthroughs, focus order and visibility review, screen-reader-oriented naming checks, zoom and reflow spot checks, and reduced-motion and contrast validation to ensure usability for low-vision and motion-sensitive users.

Does this accessibility audit approach work for dynamic content and media components?

This accessibility audit approach works for dynamic content and media components by reviewing interactive elements against WCAG 2.2 AA baseline criteria. It applies to pages and interactive components including forms, dialogs, menus, tabs, accordions, custom selects, and media to ensure correct accessible behavior.