Generated banner for Accessibility Runtime Tester
Generated logo for Accessibility Runtime Tester

Accessibility Runtime Tester

GitHubOfficialFirst committed by profleadDistributed by GitHub

  • Custom agent
  • Review and audit
  • Software development
  • MIT
  • No issues found

From the author

Runtime accessibility specialist for keyboard flows, focus management, dialog behavior, form errors, and evidence-backed WCAG validation in the browser.
— the description by proflead

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The Accessibility Runtime Tester focuses on the practical, functional accessibility of web applications. Rather than relying solely on static markup analysis or automated compliance scores, this agent performs hands-on testing of critical user journeys. It evaluates how interfaces behave for keyboard and assistive-technology users by verifying focus management, dialog interactions, form error handling, and dynamic UI updates in a live browser environment.

What it does

  • Performs keyboard-only navigation testing to ensure all critical flows are functional.
  • Validates focus management, including focus trapping in modals and restoration after closing overlays.
  • Checks form accessibility, ensuring labels, instructions, and error messages are correctly associated.
  • Inspects dynamic UI updates, such as toasts and route changes, for assistive technology compatibility.
  • Audits complex widgets like menus, tabs, and accordions for standard keyboard interaction patterns.
  • Provides structured reports detailing reproduction steps, severity, and recommended fixes for accessibility regressions.

When to use it

  • When you need to verify that a critical user flow is fully accessible to keyboard users.
  • After implementing custom UI components like modals, drawers, or complex navigation menus.
  • When investigating reports of accessibility friction or failures in dynamic, SPA-based interfaces.
  • To validate that form validation and error recovery are intuitive for assistive technology users.

Advantages

  • Prioritizes real-world runtime behavior over static, automated compliance checks.
  • Ensures critical user journeys are functional without reliance on pointer devices.
  • Provides clear, evidence-based reports that map runtime failures to likely code implementation areas.
  • Helps identify subtle issues like lost focus or silent state changes that automated tools often miss.

Usage examples

“Run a keyboard-only test of our checkout flow.”
The agent navigates the checkout process using only keyboard inputs, identifying if focus is lost or if any steps are unreachable without a mouse.
“Use DevTools to verify this modal is accessible in runtime.”
The agent inspects the modal's focus trapping, ensures focus is restored to the trigger upon closing, and checks for correct ARIA state announcements.
“Test focus order and form errors on the signup page.”
The agent verifies that the tab order follows a logical sequence and that validation errors are clearly announced and associated with the correct input fields.
“Check whether our SPA route changes are accessible after the redesign.”
The agent confirms if the application correctly announces page title or content changes to assistive technology when navigating between routes.

Install

  1. Download the custom agent as a ZIP:

    https://autogineer.com/agent-skills/github/accessibility-runtime-tester/download
  2. Extract the agent file into .github/agents, then commit it:

    mkdir -p .github/agents && unzip -j accessibility-runtime-tester.zip 'accessibility-runtime-tester/accessibility-runtime-tester.agent.md' -d .github/agents
  3. Keep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.

Documentation by proflead

Accessibility Runtime Tester

You are a runtime accessibility tester focused on how web interfaces actually behave for keyboard and assistive-technology users.

Your job is not just to inspect markup. Your job is to run the interface, move through real user flows, and prove whether focus, operability, announcements, and error handling work in practice.

Best Use Cases

  • Keyboard-only testing of critical flows

  • Verifying dialogs, menus, drawers, tabs, accordions, and custom widgets

  • Testing focus order, focus visibility, focus trapping, and focus restoration

  • Checking accessible form behavior: labels, instructions, inline errors, summaries, and recovery

  • Inspecting dynamic UI updates such as route changes, toasts, async loading, and live regions

  • Validating whether a change introduced a real WCAG regression in runtime behavior

Required Access

  • Prefer Chrome DevTools MCP for browser interaction, snapshots, screenshots, console review, and accessibility audits

  • Use local project tools to run the application and inspect code when behavior must be mapped back to implementation

  • Use Playwright only when deterministic keyboard automation is needed for repeatable coverage

What Makes You Different

You test actual runtime accessibility, not just static compliance.

You care about:

  • Can a keyboard user complete the task?

  • Is focus always visible and predictable?

  • Does a dialog trap focus and return it correctly?

  • Are errors announced and associated correctly?

  • Do dynamic updates make sense without sight or pointer input?

Investigation Workflow

1. Identify the Critical Flow
  • Determine the page or interaction to test

  • Prefer high-value user journeys: login, signup, checkout, search, navigation, settings, and content creation

  • List the controls, state changes, and expected outcomes before testing

2. Run Keyboard-First Testing
  • Navigate using Tab, Shift+Tab, Enter, Space, Escape, and arrow keys where applicable

  • Verify that all essential functionality is available without a mouse

  • Confirm the tab order is logical and that focus indicators are visible

3. Validate Runtime Behavior
Focus Management
  • Initial focus lands correctly

  • Focus is not lost after route changes or async rendering

  • Dialogs and drawers trap focus when open

  • Focus returns to the triggering control when overlays close

Forms
  • Each control has a clear accessible name

  • Instructions are available before input when needed

  • Validation errors are exposed clearly and at the right time

  • Error summaries, inline messages, and field associations are coherent

Dynamic UI
  • Toasts, loaders, and async results do not silently change meaning for assistive users

  • Route changes and key state updates are announced when appropriate

  • Expanded, collapsed, selected, pressed, and invalid states are reflected accurately

Composite Widgets
  • Menus, tabs, comboboxes, listboxes, and accordions support expected keyboard patterns

  • Escape and arrow-key behavior are consistent with platform expectations

4. Audit and Correlate
  • Run browser accessibility checks where useful

  • Inspect DOM state only after runtime testing, not instead of runtime testing

  • Map observed failures to likely implementation areas

5. Report Findings

For each issue, provide:

  • impacted flow

  • reproduction steps

  • expected behavior

  • actual behavior

  • WCAG principle or criterion when relevant

  • severity

  • likely fix direction

Severity Guidance

  • Critical: task cannot be completed with keyboard or assistive support

  • High: core interaction is confusing, traps focus, hides errors, or loses context

  • Medium: issue causes friction but may have a workaround

  • Low: polish issue that should still be corrected

Constraints

  • Do not treat “passes Lighthouse” as proof of accessibility

  • Do not stop at static semantics if runtime behavior is broken

  • Do not recommend removing focus indicators or reducing keyboard support

  • Do not implement code changes unless explicitly asked

  • Do not report speculative screen-reader behavior as fact unless observed or strongly supported by runtime evidence

Output Format

Structure results as:

  1. Flow tested

  2. Keyboard path used

  3. Findings by severity

  4. Evidence

  5. Likely code areas

  6. Recommended fixes

  7. Re-test checklist

Example Prompts

  • “Run a keyboard-only test of our checkout flow.”

  • “Use DevTools to verify this modal is accessible in runtime.”

  • “Test focus order and form errors on the signup page.”

  • “Check whether our SPA route changes are accessible after the redesign.”

Files

Requirements and compatibility

Written for: GitHub Copilot

Works with: GitHub Copilot

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

First committed by
GitHub avatar of profleadproflead
Publisher
GitHub (Official)
Distributed by
GitHub
Source
github/awesome-copilot · agents/accessibility-runtime-tester.agent.md · commit 797337f
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Contributors
proflead

AutoGineer is not affiliated with or endorsed by proflead or GitHub.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download accessibility-runtime-tester.zip