screen-reader-testing

Test web applications with VoiceOver, NVDA, JAWS, and TalkBack for accessibility validation.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/SanketAdlak/PDMProjectDesign --skill screen-reader-testing-sanketadlak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screen-reader-testing
Source: https://github.com/SanketAdlak/PDMProjectDesign/tree/main/.agents/skills/screen-reader-testing
Command: npx skills add https://github.com/SanketAdlak/PDMProjectDesign --skill screen-reader-testing-sanketadlak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web applications often fail for screen reader users due to missing labels, broken focus management, and unannounced dynamic content, and teams lack practical guidance for testing with actual assistive technologies. ## Core Features & Use Cases - Multi-Screen-Reader Coverage: Provides setup steps, keyboard commands, and testing checklists for VoiceOver, NVDA, JAWS, TalkBack, and Narrator. - ARIA Pattern Guidance: Includes tested markup and JavaScript for modals, live regions, and tab interfaces with correct focus management. - Use Case: A developer ships a new checkout form and uses this Skill to run an NVDA test script, discovering that error messages are not announced, then fixes them with role="alert" and aria-describedby. ## Quick Start Use the screen-reader-testing skill to walk me through testing my checkout page with NVDA and fix any accessibility issues found.

Frequently Asked Questions about screen-reader-testing

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

FAQPage Schema
How do I test a website with a screen reader?

Start with NVDA on Windows with Firefox or VoiceOver on macOS with Safari as minimum coverage. Navigate with arrow keys and Tab, verify page title, landmarks, headings, and form labels are announced, then test dynamic content and modals for proper announcements.

Which screen readers should I test for web accessibility?

Minimum coverage is NVDA with Firefox, VoiceOver with Safari on macOS, and VoiceOver on iOS. Comprehensive coverage adds JAWS with Chrome, TalkBack with Chrome on Android, and Narrator with Edge.

Why is my dynamic content not announced by screen readers?

Content injected into the DOM is not announced unless it uses a live region. Add role="status" with aria-live="polite" for status messages, or role="alert" with aria-live="assertive" for urgent errors that should interrupt current speech.

How do I make a modal dialog accessible to screen readers?

Use role="dialog" with aria-modal="true", aria-labelledby, and aria-describedby. Move focus into the modal on open, trap Tab and Shift+Tab within its focusable elements, close on Escape, and return focus to the triggering element.

What is the difference between browse mode and focus mode in NVDA?

Browse mode lets arrow keys read page content line by line, while focus mode passes keystrokes to interactive controls like form fields. NVDA switches automatically, and you can toggle manually with NVDA + Space.

Can I rely on automated tools instead of screen reader testing?

No. Automated tools cannot verify what a screen reader actually announces, focus behavior, or live region timing. Test with real screen readers rather than simulators, and cover error states and dynamic content, not just the happy path.