screen-reader-testing

Test web applications with screen readers including VoiceOver, NVDA, and JAWS. Use when validating screen reader compatibility, debugging accessibility issues, or ensuring assistive technology support.

By wshobson · 9,501 installs

npx skills add wshobson/agents --skill screen-reader-testing

Source repository · Upstream listing

Screen Reader Testing Practical guide to testing web applications with screen readers for comprehensive accessibility validation. When to Use This Skill Validating screen reader compatibility Testing ARIA implementations Debugging assistive technology issues Verifying form accessibility Testing dynamic content announcements Ensuring navigation accessibility Core Concepts 1. Major Screen Readers Screen Reader Platform Browser Usage VoiceOver macOS/iOS Safari ~15% NVDA Windows Firefox/Chrome ~31% JAWS Windows Chrome/IE ~40% TalkBack Android Chrome ~10% Narrator Windows Edge ~4% 2. Testing Priority 3. Screen Reader Modes Mode Purpose When Used Browse/Virtual Read content Default reading Focus/Forms Interact with controls Filling forms Application Custom widgets ARIA applications VoiceOver (macOS) Setup Essential Commands Testing Checklist Common Issues & Fixes NVDA (Windows) Setup Essential Commands Browse vs Focus Mode Testing Script JAWS (Windows) Essential Commands TalkBack (Android) Setup Gestures Common Test Scenarios 1. Modal Dialog 2. Live Regions 3. Tab Interface Debugging Tips Best Practices Do's Test with actual screen readers Not just simulators Use semantic HTML first ARIA is supplemental Test in browse and focus modes Different experiences Verify focus management Especially for SPAs Test keyboard only first Foundation for SR testing Don'ts Don't assume one SR is enough Test multiple Don't ignore mobile Growing user base Don't test only happy path Test error states Don't skip dynamic content Most common issues Don't rely on visual testing Different experience