Screen Reader Testing
Use when validating web application compatibility with screen readers, debugging ARIA or form accessibility, or verifying announcements and keyboard navigation for assistive technology users.
Install
npx skills add sandbaseai/workbuddy-skill --skill screen-reader-testinggit clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/screen-reader-testing ~/.claude/skills/screen-reader-testingPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Screen Reader Testing 验证 Web 页面是否能被屏幕阅读器理解、导航和操作。关注可访问性树、语义结构、焦点、表单错误、动态状态和自定义组件;自动化结果是证据的一部分,不能替代真实辅助技术体验。 ## 范围和安全边界 - 开始前声明目标 URL、环境、浏览器/屏幕阅读器组合、登录会话、数据范围和验收标准;优先本地、测试和合成数据。 - 默认只读检查页面结构、键盘焦点、可访问性树和视觉/控制台证据。提交表单、上传、支付、发送消息、跨域导航和生产测试需单独授权。 - 不把 ARIA 属性数量、自动化扫描通过或一台组合的结果当成完整合规证明;记录工具、版本、未覆盖项和人工验证状态。 - 截图、DOM、快照、朗读记录和网络数据脱敏,不保存令牌、Cookie、客户内容或个人数据。 ## 测试矩阵 为项目选择并记录实际可用的组合,例如: | 组合 | 重点 | |---|---| | VoiceOver + Safari(macOS/iOS) | Rotor、地标、标题、焦点和动态播报 | | NVDA + Firefox/Chrome(Windows) | Browse/Focus mode、元素列表、表单和错误 | | JAWS + Chrome(Windows) | 企业场景和复杂组件兼容性 | | TalkBack + Chrome(Android) | 触摸探索、手势、焦点和移动 viewport | | Narrator + Edge(Windows) | Windows 原生辅助技术路径 | 若无法运行真实屏幕阅读器,使用浏览器可访问性树、键盘序列和静态规则作“部分证据”,明确标注 `[TODO: real assistive-technology validation]`,不得声称已完成屏幕阅读器验证。 ## 页面加载和结构 在页面加载完成后检查并记录:标题是否有意义,是否存在唯一且正确的主地标,跳过链接是否可用,标题层级是否表达内容结构,地标是否有清晰名称,语言/方向是否正确。使用屏幕阅读器的标题、地标和链接列表逐项导航;发现重复、跳级、空名称或隐藏重要内容时保留页面与节点证据。 ## 键盘、焦点和组件 仅使用键盘完成 Tab/Shift+Tab、Enter、Space、Esc 和方向键路径。检查顺序、可见焦点、跳转、模态框焦点陷阱/返回、菜单/组合框/树/表格的角色和状态。每次 DOM 或导航变化后重新获取快照,不跨页面复用节点标识。 自定义组件必须验证角色、名称、值、状态和可操作方式;不要用 `div` 点击处理代替原生按钮/链接,除非补齐等效键盘和辅助技术语义。确认禁用、展开、选中、加载和错误状态被正确播报。 ## 表单和错误 对每个字段确认可关联 label、用途/格式说明、必填状态、输入类型、错误关联和恢复路径。用合成无效输入提交测试环境表单,验证错误文本被播报、`aria-invalid` 和 `aria-describedby` 关系正确、焦点移动到合理位置且不会丢失用户输入。记录真实提交是否被授权;未授权时只验证本地校验或拦截路径。 ## 动态内容和异步状态 触发搜索、加载、通知、验证、对话框和列表更新,检查加载状态、成功/失败结果和变化是否以适当的 live region/状态被播报,且不会重复或打断重要朗读。将“DOM 内容改变”与“用户听到了有用提示”分开记录;确认无障碍名称不会被视觉装饰或隐藏文本污染。 ## 证据和交付
Details
- Skill name
screen-reader-testing- Repository
- sandbaseai/workbuddy-skill
- Path
skills/screen-reader-testing/SKILL.md- License
- MIT
- Repo updated
- 8 September 2026
FAQ
What does the Screen Reader Testing skill do?
Use when validating web application compatibility with screen readers, debugging ARIA or form accessibility, or verifying announcements and keyboard navigation for assistive technology users.
How do I install the Screen Reader Testing skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill screen-reader-testing. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Screen Reader Testing popular?
It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.
Related skills
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Spring Boot Testing
9sandbaseai/workbuddy-skill
Expert Spring Boot 4 testing specialist that selects the best Spring Boot testing techniques for your situation with Junit 6 and AssertJ.
Respec
9sandbaseai/workbuddy-skill
Use when implementation, testing, or review reveals that an existing feature specification must be revised before work can proceed safely.
Temporal Python Testing
9sandbaseai/workbuddy-skill
Use when testing Temporal Python workflows or activities with pytest; choose time-skipping, activity isolation, worker integration, and replay tests deliberately, and verify determinism and version compatibility before deployment.
Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.