Skip to content

smukh/a11y-agent-skills

v0.2.0MIT

Verification-first accessibility engineering skills for finding regressions, repairing source, and proving the repair.

accessibility-audit

Audits a defined page or component state with deterministic browser evidence and explicit manual-review boundaries. Use for accessibility audits, axe scans, WCAG checks, or when asked to find accessibility barriers without yet changing source.

accessibility-regression-test

Converts a verified accessibility repair into the narrowest durable user-behavior test. Use after an accessibility fix or when asked for an axe, component, Playwright, keyboard-journey, or manual accessibility regression record.

accessible-authentication

Reviews login, MFA, one-time codes, recovery, and reauthentication for accessible completion. Use for authentication-specific accessibility; use accessible-forms for general labeling and validation.

accessible-charts-and-dashboards

Reviews charts and dashboard interactions for equivalent information access, data alternatives, filtering, and nonvisual operation. Use for data visualization accessibility when source data and chart purpose can be inspected.

accessible-combobox-and-autocomplete

Reviews editable comboboxes and suggestion popups, including async search, active options, selection, and dismissal. Use for autocomplete or custom select accessibility; ordinary native selects need no custom keyboard model.

accessible-component-review

Reviews an interface component's native semantics, name-role-value, keyboard behavior, focus, colors, motion, target size, announcements, and disabled states. Use for design-system, component, widget, button, menu, tabs, toggle, tooltip, or interactive UI accessibility.

accessible-data-tables-and-grids

Reviews native data tables and interactive grids, including sorting, editing, selection, pagination, and virtualized rows. Use for tabular-data accessibility rather than CSS layout grids.

accessible-dynamic-updates

Reviews asynchronous status, SPA transitions, search results, chat, and streamed responses for focus continuity and appropriate announcements. Use when content changes without a full page reload.

accessible-forms

Reviews and repairs accessible form labeling, instructions, autocomplete, grouping, validation, error summaries, announcements, redundant entry, and authentication. Use for form, field, label, validation, error-message, autocomplete, or login accessibility work.

dialog-accessibility

Reviews or repairs modal and non-modal dialog behavior, including naming, initial focus, containment, Escape, inert background, close controls, and focus restoration. Use for dialog, modal, drawer, popover-as-dialog, or focus-trap work.

fix-accessibility-issue

Repairs confirmed accessibility findings in responsible source code and verifies the same state afterward. Use when asked to fix an accessibility issue, axe finding, keyboard failure, or accessibility regression—not for an evidence-only audit.

keyboard-navigation-review

Reviews repeatable keyboard-only journeys for reachability, focus order, traps, skip links, composite widgets, and focus restoration. Use for keyboard navigation, focus, tab order, menu keys, or keyboard-trap requests.