code-check-accessibility-regression

Scan changed TSX/JSX files for accessibility regressions and prioritize findings.

22|3|Updated Jul 28, 2024
One-click install
npx skills add https://github.com/webdevcody/go-mailing-list --skill code-check-accessibility-regression
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-check-accessibility-regression
Source: https://github.com/webdevcody/go-mailing-list/tree/main/.claude/skills/code-check-accessibility-regression
Command: npx skills add https://github.com/webdevcody/go-mailing-list --skill code-check-accessibility-regression

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the risk of shipping accessibility regressions by quickly scanning only the files changed in a PR for common, high-impact UI issues.

Core Features & Use Cases

  • Changed-files-only audit focused on the JSX/TSX diff to avoid whole-app noise, prioritizing findings by severity.
  • Targeted detectors with safe mechanics for frequent problems like missing accessible names, mis-associated labels/errors, clickable non-interactive elements, and missing decorative image alt handling.
  • Dialog focus-trap verification to flag custom dialogs that may trap focus incorrectly, while skipping Radix/shadcn-style primitives to avoid false positives.
  • Use case: After adding a new settings page or modifying a form/route, run this post-step to ensure keyboard navigation and screen reader semantics still work.

Quick Start

Run the code-check-accessibility-regression skill after your UI change to automatically audit the changed TSX/JSX files and report prioritized accessibility issues.

Frequently Asked Questions about code-check-accessibility-regression

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

FAQPage Schema
How do I check React components for accessibility regressions after a UI change?

Catching accessibility regressions in changed UI requires scanning only the modified TSX or JSX files for missing accessible names, mis-associated form labels, and unsafe keyboard interactions. This targeted diff scan avoids whole-app noise and prioritizes high-severity findings.

How does a dialog focus trap check work for custom React UI?

A dialog focus trap check flags custom dialogs that may incorrectly trap keyboard focus, ensuring safe screen reader navigation. It skips Radix or shadcn-style primitives to avoid false positives on established component libraries.

Does the accessibility audit work with changed files only in a React PR?

Yes, the accessibility audit works with changed files only by running grep-style detectors on the JSX or TSX diff. This avoids whole-app noise and provides faster feedback by prioritizing high-severity semantic and interaction failures.

What common form labeling issues cause screen reader failures in React?

Common screen reader failures in React include mis-associated form labels, missing accessible names, and unlabeled errors. The audit detects these by scanning changed files for proper label and error associations to mitigate a11y regressions.

How do I ensure keyboard navigation works in new UI components without false positives?

To ensure keyboard navigation works without false positives, the scan flags clickable non-interactive elements and missing focus handling while skipping Radix or shadcn-style primitives. This enforces keyboard-safe interactions on custom UI mutations.