smukh/a11y-agent-skills

keyboard-navigation-review

Reviews repeatable keyboard-only journeys for reachability, focus order, traps, skip links, composite widgets, and focus restoration.

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 keyboard-navigation-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.

Keyboard navigation review

Evaluate a bounded task with real browser key presses. Synthetic keyboard evidence is useful but is not complete assistive-technology evidence.

Workflow

  1. Define the starting URL/state, viewport, task completion condition, and

expected focus behavior.

  1. Run a11y-agent keyboard <url> --journey <file> or perform the equivalent

physical-key review. Journey files must use only the bounded actions in references/journey-review.md; never add arbitrary JavaScript.

  1. Check reachability, visible focus, logical sequence, traps, skip links,

composite-widget arrow-key behavior, route/state changes, dialog entry, and focus restoration.

  1. Record every action, resulting focused element, accessible name, and failure

reason.

  1. Replay any repair from the identical starting state and add a

behavior-focused regression journey.

Boundaries

Do not infer that a passing scripted journey works with every keyboard layout, switch device, voice input system, browser, or screen reader. Manual review remains required for visual focus quality and task-level sequence judgment.

from this repository

More skills

All skills