keyboard-focus-accessibility-audit

Audits keyboard operability and focus behavior in web interfaces using source inspection and manual keyboard testing.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/vmitsaras/Agent-Skills --skill keyboard-focus-accessibility-audit-vmitsaras
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: keyboard-focus-accessibility-audit
Source: https://github.com/vmitsaras/Agent-Skills/tree/main/skills/frontend-a11y/keyboard-focus-accessibility-audit
Command: npx skills add https://github.com/vmitsaras/Agent-Skills --skill keyboard-focus-accessibility-audit-vmitsaras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keyboard users often encounter unreachable controls, illogical tab order, invisible focus indicators, focus traps, and pointer-only interactions that block task completion. This Skill produces evidence-based findings that separate source-confirmed defects from behavior requiring runtime verification, mapped to applicable WCAG success criteria. ## Core Features & Use Cases - Comprehensive Keyboard Coverage: Audits tab order, focus visibility, focus movement and restoration, dialogs and overlays, custom composite widgets, keyboard shortcuts, disabled states, and pointer-only interactions. - Dual Evidence Model: Combines deterministic source-code inspection with manual keyboard testing in a running interface, assigning statuses like confirmed, provisional, or needs-validation. - WCAG 2.2 Mapping: Maps confirmed findings to specific success criteria (2.1.1 Keyboard, 2.4.3 Focus Order, 2.4.7 Focus Visible, and more) with per-finding rationale, without claiming full conformance. - Use Case: A QA team reviewing a design-system dialog component can run this audit to verify focus containment, Escape behavior, and focus restoration, receiving a structured report with severity, user impact, and retest steps. ## Quick Start Audit the checkout flow in this repository for keyboard accessibility and focus management issues, and report confirmed findings with WCAG mappings.

Frequently Asked Questions about keyboard-focus-accessibility-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a website for keyboard accessibility?▼

Traverse the interface using only Tab and Shift+Tab, complete critical tasks without a pointer, and verify focus visibility, order, and restoration. This Skill guides that process by combining source-code inspection with manual keyboard testing and produces structured findings mapped to WCAG criteria.

How to test focus management in dialogs and modals?▼

Verify the modal receives focus on open, contains the tab sequence, blocks background interaction, offers a keyboard-operable close, and restores focus on dismissal. The audit also checks nested overlays and Escape behavior layer by layer.

Which WCAG criteria cover keyboard and focus accessibility?▼

Key WCAG 2.2 criteria include 2.1.1 Keyboard, 2.1.2 No Keyboard Trap, 2.1.4 Character Key Shortcuts, 2.4.3 Focus Order, 2.4.7 Focus Visible, and 2.4.11 Focus Not Obscured. The audit maps confirmed findings to the smallest applicable set with evidence-specific rationale.

Can automated tools replace manual keyboard testing?▼

No. Automated scanners, DOM-order inspection, and synthetic events cannot confirm actual tab sequences, focus visibility, focus restoration, or task completion. The audit requires real key input in a running interface for runtime-dependent claims.

Does this audit prove full WCAG conformance?▼

No. The audit reports scoped, evidence-based findings and verified checks limited to tested states and environments. It explicitly does not establish complete accessibility or WCAG conformance for a page or product.

What happens if there is no running interface to test?▼

The audit completes the source pass and reports only deterministic source defects as confirmed. Behavior that requires rendered interaction is placed in a needs-validation queue with exact manual steps and required evidence.