accessibility-guard

Audit React/Next.js UI code for WCAG 2.2 AA accessibility compliance.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/lgerard314/global-plugin --skill accessibility-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-guard
Source: https://github.com/lgerard314/global-plugin/tree/main/plugin/skills/accessibility-guard
Command: npx skills add https://github.com/lgerard314/global-plugin --skill accessibility-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ensure every interface is usable by people who navigate with keyboards, screen readers, magnifiers, or reduced motion. This guard applies to all interactive UI and prevents inaccessible experiences.

Core Features & Use Cases

  • Keyboard navigation and focus indicators: all interactive elements are reachable in a logical tab order.
  • Semantic HTML first: prefer native elements over ARIA where possible, with proper labeling and error messaging.
  • ARIA patterns and WCAG compliance: follow WAI-ARIA APG guidance for modal dialogs, tabs, and other widgets.
  • Color contrast and motion: enforce WCAG 2.2 AA contrast and respect prefers-reduced-motion.
  • Forms and non-text content: ensure labels, aria-describedby, and accessible labels for icons.
  • Focus management: manage focus on route changes, modals, and dynamic content insertion.

Quick Start

Run accessibility-guard checks on your UI code to verify keyboard focus, semantic HTML, ARIA correctness, color contrast, and motion preferences.

Frequently Asked Questions about accessibility-guard

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

FAQPage Schema
How do I check my React components for WCAG 2.2 AA compliance?

To check React components for WCAG 2.2 AA compliance, audit the UI code to enforce inclusive patterns for keyboard navigation, focus management, and semantic HTML. This ensures proper labeling and avoids color-only cues for interactive elements.

What is the best way to manage focus in modal dialogs for screen readers?

Managing focus in modal dialogs requires following WAI-ARIA APG guidance to trap focus within the dialog and return it to the trigger upon closure. Proper ARIA usage ensures screen readers announce dynamic content insertion correctly.

How do I ensure keyboard navigation works across all interactive elements?

Ensuring keyboard navigation works requires auditing your UI code to verify all interactive elements are reachable in a logical tab order. You must enforce proper focus indicators and semantic HTML first, preferring native elements over ARIA where possible.

Does this accessibility audit cover forms and prefers-reduced-motion settings?

Yes, the accessibility audit covers forms and prefers-reduced-motion settings. It evaluates forms for proper labels, aria-describedby for errors, and accessible labels for icons, while also enforcing WCAG 2.2 AA contrast and respecting motion preferences.

Why are my aria-live regions not announcing form errors correctly?

Aria-live regions may not announce form errors correctly if the UI code lacks proper aria-describedby linkages or semantic HTML error messaging. Auditing the ARIA patterns ensures dynamic error insertions are properly labeled and announced to assistive technologies.

Can I use accessibility-guard for Next.js navigational elements and route changes?

Yes, you can use accessibility-guard for Next.js navigational elements and route changes. It audits focus management during route transitions and verifies navigational elements across web and mobile interfaces for proper WCAG 2.2 AA compliance.