smukh/a11y-agent-skills

accessible-component-review

Reviews an interface component's native semantics, name-role-value, keyboard behavior, focus, colors, motion, target size, announcements, and disabled states.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/smukh/a11y-agent-skills --skill accessible-component-review

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Accessible component review

Review every supported state and input path of one reusable component.

Workflow

  1. Inventory states, variants, input methods, content slots, and expected

semantics.

  1. Select the native element that already provides the behavior. Use ARIA

patterns only when native HTML cannot provide the required interaction.

  1. Apply references/component-checklist.md

to each state.

  1. Run deterministic rules, keyboard behavior, forced-colors, reduced-motion,

zoom/reflow, and pointer target checks. Record manual judgment separately.

  1. Trace failures to the component source and repair the smallest shared layer

that owns the defect.

  1. Add tests for user-visible behavior and verify consuming examples do not

regress.

Boundaries

Do not add ARIA that duplicates or conflicts with native semantics. Do not treat a single Storybook example as coverage of every consumer. Do not assert that an accessible name is meaningful without content context.

from this repository

More skills

All skills