screen-reader-testingpor Seth Hobson

Screen Reader Testing Skill.

Uma skill de Claude Code e Codex para revisão de design: testa aplicações web com leitores de tela VoiceOver, NVDA e JAWS.

Design Review & Accessibility
Relatório de revisão

Baixar OpenDesign Ver guia de uso

wshobson/agents · plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.mdSKILL.md

--- name: screen-reader-testing description: 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. --- ## When to Use This Skill ## Core Concepts ## VoiceOver (macOS) ## VoiceOver Testing Checklist ## NVDA (Windows) ## NVDA Test Script

Front matter e títulos de seção lidos do arquivo original em 2026-09-14 · 12.020 caracteres no total

01 O que faz

O Que a Skill screen-reader-testing Faz no Claude Code e no Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

Testa aplicações web com os leitores de tela VoiceOver, NVDA, JAWS, TalkBack e Narrator nas plataformas macOS, Windows, iOS e Android. Valida a compatibilidade com leitores de tela, depura problemas de tecnologia assistiva e garante implementações de ARIA corretas por meio de testes práticos com leitores de tela reais.

Aborda navegação, formulários, anúncios de conteúdo dinâmico, gerenciamento de foco e diálogos modais. Fornece comandos específicos por plataforma, checklists de teste e exemplos de código para padrões comuns de acessibilidade. Enfatiza o teste em diferentes modos de leitor de tela (navegação, foco, aplicação) e prioriza HTML semântico com ARIA como aprimoramento complementar.

O que ele produz

Checklist de Teste do VoiceOver cobrindo carregamento de página, navegação, links, formulários, conteúdo dinâmico e tabelas
Script de Teste do NVDA com instruções passo a passo para carregamento inicial, landmarks, cabeçalhos, formulários, elementos interativos e conteúdo dinâmico
Exemplos de código HTML que mostram padrões acessíveis e correções para problemas comuns, como botões sem rótulo, conteúdo dinâmico não anunciado e erros de formulário
Código JavaScript para gerenciamento de foco, incluindo diálogos modais, retenção de foco (focus trapping) e navegação por teclado em interfaces de abas

Veja o exemplo de prompt ↗

Como funciona

01
Testar com os Principais Leitores de Tela por Plataforma
Use o NVDA com o Firefox no Windows (31% de uso), o VoiceOver com o Safari no macOS e iOS (15% de uso), o JAWS com o Chrome (40% de uso), o TalkBack no Android (10% de uso) e o Narrator com o Edge (4% de uso).
02
Navegar Usando Comandos Específicos do Leitor de Tela
Execute comandos como VO+Seta para Direita para navegação por elementos no VoiceOver, H para saltos entre cabeçalhos no NVDA, Insert+F7 para listas de links no JAWS e deslize com dois dedos para rolagem no TalkBack.
03
Testar nos Modos de Navegação e Foco
Verifique se os leitores de tela alternam corretamente entre o modo de navegação, para leitura de conteúdo, e o modo de foco, para interação com controles de formulário, observando os anúncios de mudança de modo.
04
Validar a Estrutura Semântica e o ARIA
Verifique se os cabeçalhos são detectáveis pelo rotor ou pela lista de elementos, se os landmarks estão rotulados corretamente, se as regiões dinâmicas (live regions) anunciam atualizações e se roles como dialog, tab e progressbar estão implementados corretamente.
05
Verificar o Gerenciamento de Foco e a Interação por Teclado
Garanta que o foco se mova para os erros após o envio do formulário, que os modais retenham o foco corretamente e o devolvam ao fechar, e que as interfaces de abas respondam às setas, Home e End.
06
Testar Anúncios de Conteúdo Dinâmico
Acione atualizações de conteúdo e confirme que role="status" com aria-live="polite" anuncia as mudanças após a fala atual, enquanto role="alert" interrompe imediatamente.

02 Encontre o ideal para você

Quando usar a skill screen-reader-testing

Use a skill screen-reader-testing no Claude Code ou Codex quando o trabalho for revisão de design deste tipo. Adequação e limites abaixo são do próprio arquivo da skill.

Boa Combinação

Validar que uma aplicação web funciona corretamente com software leitor de tela
Testar se roles, estados e propriedades de ARIA estão implementados corretamente
Depurar problemas que afetam usuários de tecnologias assistivas
Garantir que os controles de formulário sejam acessíveis, com rótulos e anúncios de erro adequados
Testar se as atualizações de conteúdo dinâmico são anunciadas aos usuários de leitores de tela

Conheça os Limites

Confiar apenas na inspeção visual para validar a acessibilidade
Testar apenas os caminhos de sucesso sem validar estados de erro e casos extremos
Ignorando o teste de leitor de tela mobile no iOS e Android

03 Dentro da skill

Regras que a skill screen-reader-testing dá ao Claude Code e ao Codex

8 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

Teste com Leitores de Tela Reais, Não Simuladores
Sempre teste usando software real de leitor de tela (VoiceOver, NVDA, JAWS, TalkBack, Narrator) em vez de ferramentas de simulação ou emuladores.
Use HTML Semântico Primeiro, ARIA É Complementar
Construa interfaces com elementos HTML nativos antes de adicionar atributos ARIA. O ARIA melhora o HTML semântico, mas não o substitui.
Cobertura Mínima: NVDA+Firefox, VoiceOver+Safari no macOS e iOS
No mínimo, teste com NVDA combinado com Firefox no Windows, VoiceOver com Safari no macOS e VoiceOver com Safari no iOS antes de considerar a aplicação validada.
Teste nos Modos de Navegação e Foco
Verifique a experiência no modo de navegação (para ler conteúdo com as setas) e no modo de foco (para interagir com controles), já que os leitores de tela alternam entre eles automaticamente ou manualmente.
Teste a Navegação Somente por Teclado Antes do Teste com Leitor de Tela
Conclua primeiro o teste somente por teclado, pois ele é a base para a acessibilidade com leitor de tela e detecta problemas de interação desde o início.
Verifique o Gerenciamento de Foco em Aplicações single-page
Garanta que o foco seja gerenciado corretamente quando o conteúdo muda dinamicamente, especialmente em SPAs, onde as transições de página ocorrem sem recarregamento completo.
Nunca Teste com Apenas um Leitor de Tela
Testar com um único leitor de tela é insuficiente. Leitores de tela diferentes têm comportamentos e padrões de uso diferentes entre plataformas.
Sempre Teste Conteúdo Dinâmico e Estados de Erro
Não deixe de testar conteúdo que é atualizado dinamicamente nem limite o teste ao caminho ideal. Conteúdo dinâmico e tratamento de erros são as fontes mais comuns de problemas de acessibilidade.

04 Coloque em prática

Instale screen-reader-testing no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicione screen-reader-testing ao Claude Code, Codex ou Seu Agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

Terminal

npx skills add https://github.com/wshobson/agents --skill screen-reader-testing

Formato genérico da CLI skills para plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md; o repositório pode documentar seu próprio caminho.

Dar à Skill uma Primeira Tarefa de Revisão de Design

Escrito nos próprios termos do skill; substitua as partes entre colchetes pelo seu material.

Starter prompt

Test the [checkout form] on [staging.example.com] with NVDA and VoiceOver to verify that all field labels are announced, required field indicators are read correctly, validation errors are communicated when the form is submitted with invalid data, and focus moves to the first error. Also confirm that the loading state during payment processing is announced and the success confirmation is read by the screen reader.

Fonte: escrito a partir do SKILL.md nos próprios termos do skill.

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

Verifique se o título da página é anunciado quando a página carrega
Confirme se todos os títulos podem ser encontrados usando o rotor (VoiceOver) ou a lista de elementos (NVDA, JAWS)
Verifique se os rótulos são lidos junto com seus campos de entrada associados
Garanta que as mensagens de erro sejam anunciadas quando formulários são enviados com dados inválidos
Verifique se o foco é retido corretamente dentro de diálogos modais e não pode escapar

No OpenDesign importe screen-reader-testing a partir do link do SKILL.md: Plugins → Add → Skill → Import from link, depois selecione-o na barra superior.

Baixar OpenDesign Ler o quickstart

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Author: Seth Hobson
Repository: github.com/wshobson/agents Branch main
Arquivo da skill: plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md Checksum de conteúdo registrado na verificação; commit 4236bb9
License: MIT Do LICENSE.
Estrelas do repositório: 39.635 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório wshobson/agents, que contém 18 skills neste catálogo. Não é uma classificação ou contagem de uso para screen-reader-testing.
Verificado pelo OpenDesign: 14/09/2026 Arquivo de origem, caminho, texto da licença e contagem de estrelas foram verificados. Não integrado ao OpenDesign principal (verificado em 28/08/2026); uma execução ao vivo não foi registrada nesta página.

Dentro do SKILL.md

Quando Usar Este SkillLista cenários como validar compatibilidade, testar ARIA, depurar tecnologia assistiva e verificar formulários e navegação
Conceitos FundamentaisAborda os principais leitores de tela por plataforma e uso, prioridade mínima de teste, e modos de navegação vs. foco vs. aplicação
VoiceOver (macOS)Instruções de configuração, comandos essenciais com teclas modificadoras, navegação pelo rotor, checklist de testes e correções de problemas comuns de HTML/ARIA
NVDA (Windows)Configuração e comandos, navegação por títulos e landmarks, alternância entre modo de navegação e modo de foco, e script de teste passo a passo
JAWS (Windows)Comandos essenciais incluindo cursor virtual, teclas rápidas para tipos de elementos, modo de formulários e atalhos de navegação em tabelas
TalkBack (Android)Alternância de configuração, gestos de toque para navegação e ativação, e opções de granularidade de controle de leitura
Cenários de Teste ComunsPadrões acessíveis com código para diálogos modais com retenção de foco, regiões dinâmicas (live regions) e interfaces em abas com suporte a teclado
Dicas de DepuraçãoFunção JavaScript para registrar nome acessível, papel, estado e visibilidade dos elementos como são percebidos pelos leitores de tela
Boas PráticasO que fazer e o que evitar, cobrindo testes reais, prioridade de HTML semântico, teste por modo, gerenciamento de foco e evitar validação com um único leitor de tela

A Descrição da Própria Skill

"Teste aplicações web com leitores de tela incluindo VoiceOver, NVDA e JAWS. Use ao validar compatibilidade com leitores de tela, depurar problemas de acessibilidade ou garantir suporte a tecnologias assistivas."

Descrição do front-matter do SKILL.md. O arquivo completo tem cerca de 12.020 caracteres. Leia o arquivo completo no GitHub.

Testes com Leitor de Tela

Execute screen-reader-testing em uma Tarefa Real de Revisão de Design.

Baixe o OpenDesign, importe screen-reader-testing a partir do seu link SKILL.md, cole o prompt acima e leia o plano antes do resultado.

Baixar OpenDesign Ver todas as skills

Terminal

npx skills add https://github.com/wshobson/agents --skill screen-reader-testing

O Que a Skill screen-reader-testing Faz no Claude Code e no Codex

Nos termos do próprio skill

Como funciona

Quando usar a skill screen-reader-testing

Boa Combinação

Conheça os Limites

Regras que a skill screen-reader-testing dá ao Claude Code e ao Codex

Teste com Leitores de Tela Reais, Não Simuladores

Use HTML Semântico Primeiro, ARIA É Complementar

Cobertura Mínima: NVDA+Firefox, VoiceOver+Safari no macOS e iOS

Teste nos Modos de Navegação e Foco

Teste a Navegação Somente por Teclado Antes do Teste com Leitor de Tela

Verifique o Gerenciamento de Foco em Aplicações single-page

Nunca Teste com Apenas um Leitor de Tela

Sempre Teste Conteúdo Dinâmico e Estados de Erro