Better Accessibility is an agent skill that reviews a UI in two walks: keyboard-only, where every flow must finish without a mouse, and screen-reader, where every control announces a name, a role and its state. Each failure is reported against the WCAG 2.2 Level A or AA criterion it breaks, and the fix is written in the project’s own styling system.
It favors native elements over custom ones, and removing ARIA over adding it. Contrast measurement, text sizing, spacing, copy and animation recipes are handed to the sibling skills that own them.
What You Get
- A review that groups findings under the principle each one violates, ordered by severity, with the file and line, the current code, the fix and the WCAG criterion
- Fixes for focus rings, focus order, dialogs, route changes and roving tabindex, written in the project’s styling system
- Form guidance covering labels, autocomplete tokens, inputmode, inline errors tied to fields with aria-describedby and focus on the first invalid field
- Checks for live regions, alt text by purpose, landmarks, skip links, reduced motion, pause controls, 200% text resize and 320px reflow
- A Block or Approve verdict, with every check it could not run listed as Not verified
Common Use Cases
- Auditing a new modal, menu or combobox for keyboard support and focus return before it ships
- Fixing a form whose errors are not announced and whose submit button is disabled until it is valid
- Checking an icon-only toolbar for accessible names and hit areas
- Reviewing a page for reduced-motion handling, zoom behavior and viewport meta settings
What Makes It Unique
The skill separates a failure from a preference. Only a WCAG 2.2 A or AA criterion, a task a user cannot finish or a listed trigger can reach HIGH, and heuristics such as 44px targets or the one-h1 rule stay recommendations. It also names the sibling skills that own contrast, type, layout, copy and animation, so each rule has one home.
Under The Hood
The skill is a SKILL.md with seven reference files for focus and keyboard, forms, hit areas, motion and zoom, screen readers, semantics and ARIA, and reporting. It contains no scripts. The agent reads your source and, when a browser is available, tabs through the flow, reads computed names and roles from the accessibility tree and runs an automated audit. A review leaves your files untouched, and edits happen only when you ask for the fixes to be applied.