smukh/a11y-agent-skills

dialog-accessibility

Reviews or repairs modal and non-modal dialog behavior, including naming, initial focus, containment, Escape, inert background, close controls, 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 dialog-accessibility

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.

Dialog accessibility

Verify the whole open–operate–close lifecycle.

Workflow

  1. Decide whether native <dialog> meets the product behavior before retaining

a custom dialog.

  1. Open it from a known invoker and apply

references/dialog-checklist.md.

  1. Verify the accessible name and any useful description, deliberate initial

focus, containment for a modal, background inertness, keyboard-operable close control, Escape behavior, and restoration to the logical invoker.

  1. Test close by every offered path and test DOM removal or route changes that

invalidate the invoker.

  1. Replay at mobile width and high zoom. Assess nested dialogs as a separate

high-risk interaction.

  1. Save a bounded keyboard journey and rerun the relevant deterministic scan

after repairs.

Boundaries

Do not force focus to the first interactive control when a heading or explanatory content is the more useful starting point. Do not add role=dialog without implementing the interaction model. A passing axe scan does not prove containment, restoration, or mobile usability.

from this repository

More skills

All skills