screen-reader-testing

Vue d’ensemble de la skill screen-reader-testing

Ce que fait la skill screen-reader-testing

La skill screen-reader-testing est un guide de test concret pour vérifier le comportement d’une application web avec de vrais lecteurs d’écran, et pas seulement avec des scanners d’accessibilité automatisés. Elle est conçue pour les audits UX, la QA accessibilité, la validation ARIA, les tests de formulaires et le débogage des cas où une page semble correcte visuellement mais échoue pour les utilisateurs de technologies d’assistance.

À qui s’adresse l’installation

Cette skill screen-reader-testing convient particulièrement à :

• les auditeurs UX qui ont besoin d’un workflow manuel d’accessibilité reproductible
• les ingénieurs frontend qui déboguent des problèmes de clavier et d’annonces vocales
• les designers qui valident des patterns d’interaction avant mise en production
• les équipes QA qui ajoutent des contrôles de technologies d’assistance aux tests d’acceptation
• les équipes qui se préparent à des revues centrées sur WCAG, lorsque les contrôles automatisés ne suffisent pas

Le vrai besoin métier auquel elle répond

La plupart des utilisateurs n’ont pas besoin d’un discours générique sur l’accessibilité. Ils ont besoin de répondre à des questions comme :

• Quelles combinaisons lecteur d’écran + navigateur faut-il couvrir en priorité ?
• Comment tester de façon réaliste les formulaires, boîtes de dialogue, menus et mises à jour dynamiques ?
• À quoi faut-il prêter l’oreille pendant la navigation ?
• Comment transformer une demande floue du type « vérifier l’accessibilité » en audit UX ciblé ?

La skill screen-reader-testing aide à structurer ce travail de test manuel.

Pourquoi cette skill est plus utile qu’un prompt générique

Un prompt générique risque de lister des bonnes pratiques d’accessibilité. Cette skill est plus utile lorsque vous avez besoin d’un guide screen-reader-testing orienté exécution, avec :

• des priorités concrètes de couverture par plateforme
• une distinction claire entre les principaux lecteurs d’écran comme VoiceOver, NVDA, JAWS, TalkBack et Narrator
• un focus de test sur le mode lecture par opposition au mode interaction
• des cas d’usage pratiques comme les formulaires, le comportement ARIA, les annonces dynamiques et la navigation

Ce qu’il faut savoir avant de l’adopter

La valeur principale réside dans l’aide à la décision et la structuration du workflow, pas dans l’automatisation. Cette skill ne remplace pas l’exécution réelle du lecteur d’écran sur la plateforme cible. Installez-la si vous voulez mieux planifier vos tests, formuler de meilleurs prompts pour un agent et réduire les angles morts lors d’une revue de compatibilité avec les lecteurs d’écran.

Comment utiliser la skill screen-reader-testing

Contexte d’installation pour screen-reader-testing

Installez la skill depuis le dépôt wshobson/agents dans votre environnement compatible avec les skills :

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

Si votre environnement d’agent utilise un autre chargeur de skills, adaptez l’étape d’installation à cet outil. L’essentiel est de récupérer la skill screen-reader-testing depuis le chemin plugins/accessibility-compliance/skills/screen-reader-testing du dépôt.

Commencez par lire ce fichier

Commencez par :

• SKILL.md

Cette portion du dépôt n’expose que SKILL.md. La décision d’adoption dépend donc surtout de l’adéquation entre son cadre de test et votre workflow. Vous n’aurez ici ni scripts d’assistance ni fichiers de référence : prévoyez d’apporter vous-même le contexte de votre application, les parcours à cibler et les contraintes de plateforme.

Les entrées nécessaires pour que la skill fonctionne bien

La skill screen-reader-testing donne de bien meilleurs résultats si vous fournissez :

• le type de produit : site marketing, application SaaS, dashboard, tunnel de checkout, workflow riche en formulaires
• le parcours utilisateur visé : connexion, recherche, checkout, création d’enregistrement, soumission de formulaire
• les plateformes cibles : Windows, macOS, iOS, Android
• les contraintes navigateur : Safari, Firefox, Chrome, Edge
• les types de composants concernés : modal, tabs, menu button, combobox, live region, data table
• les problèmes connus ou soupçonnés : labels manquants, ordre de tabulation cassé, annonces dupliquées, mises à jour silencieuses

Entrée faible :

• « Teste mon site pour les lecteurs d’écran. »

Entrée solide :

• « Use the screen-reader-testing skill to review our signup flow for NVDA + Firefox and VoiceOver + Safari. Focus on field labels, error announcements, password requirements, focus movement after validation, and whether success feedback is announced. »

Choisir une couverture de plateforme plutôt que tout tester

La skill propose un modèle de priorisation utile. En pratique, commencez par :

1. NVDA + Firefox sur Windows
2. VoiceOver + Safari sur macOS
3. VoiceOver + Safari sur iOS

N’élargissez à JAWS + Chrome, TalkBack + Chrome et Narrator + Edge que si le niveau de risque produit, la base d’utilisateurs ou les exigences de conformité justifient une couverture plus large. Cela fait gagner du temps et permet de garder un audit UX réaliste.

Transformer un objectif vague en meilleur prompt

Un bon prompt de screen-reader-testing usage doit préciser :

• le parcours
• le couple technologie d’assistance
• les types d’interaction
• le format de sortie attendu

Exemple :

« Use the screen-reader-testing skill for a UX audit of our checkout flow. Prioritize NVDA + Firefox and VoiceOver + Safari. Test browse reading, form entry, validation errors, shipping method radio groups, promo code updates, and payment confirmation announcements. Return findings by severity, reproduction steps, expected screen reader behavior, and likely markup causes. »

Ce prompt est meilleur parce qu’il définit le périmètre, la couverture et la structure du reporting.

Utiliser la skill pour les bons types de problèmes

Ce guide screen-reader-testing est particulièrement adapté à :

• la validation d’implémentations ARIA
• le comportement des labels et des erreurs de formulaire
• les vérifications d’annonces de contenu dynamique
• les revues de gestion du focus
• l’utilisabilité de la navigation et des landmarks
• les tests visant à vérifier si des widgets custom se comportent comme des contrôles natifs

Il est moins utile comme outil autonome pour le contraste de couleurs, la revue de mise en page visuelle ou la cartographie complète de conformité légale, sauf si vous le combinez avec d’autres contrôles d’accessibilité.

Workflow pratique de screen-reader-testing pour un audit UX

Un workflow solide ressemble à ceci :

1. Identifier les principaux parcours utilisateurs.
2. Choisir la couverture minimale en lecteurs d’écran.
3. Tester d’abord l’ordre de lecture et la structure de la page.
4. Tester ensuite les contrôles interactifs.
5. Déclencher tous les états de validation et de mise à jour dynamique.
6. Noter ce qui est annoncé, ignoré, dupliqué ou source de confusion.
7. Transformer les observations en notes de remédiation exploitables côté code.

Cet ordre compte, car beaucoup d’équipes se jettent dans les détails des composants avant d’avoir vérifié les titres, landmarks, titres de page et le flux de lecture.

Ce qu’il faut écouter pendant les tests

La skill est la plus efficace quand vous consignez activement :

• si les titres construisent une hiérarchie compréhensible
• si les landmarks aident réellement à s’orienter
• si les liens et boutons ont des noms distincts
• si les champs de formulaire exposent labels, instructions et erreurs
• si les changements d’état sont annoncés
• si le focus arrive là où les utilisateurs s’y attendent après l’ouverture de boîtes de dialogue, l’envoi de formulaires ou un changement de vue

Ces observations produisent des constats bien plus actionnables qu’une simple liste réussite/échec.

Comprendre les modes des lecteurs d’écran avant de tester les widgets

Le contenu source distingue le mode lecture du mode interaction. C’est important, car beaucoup de widgets semblent « corrects » en lecture mais cassent à l’usage réel. Demandez à l’agent de tester les deux :

• la découverte du contenu en mode browse ou virtuel
• l’interaction directe en mode focus ou formulaires

C’est particulièrement important pour les menus, comboboxes, boîtes de dialogue modales, sélecteurs de date et listes déroulantes custom.

La meilleure façon d’exploiter la sortie avec les ingénieurs

Demandez des constats dans un format exploitable par les ingénieurs :

• résumé du problème
• lecteur d’écran et navigateur affectés
• chemin exact de reproduction
• annonce ou comportement observé
• comportement attendu
• cause technique probable, par exemple nom manquant, rôle incorrect, gestion du focus cassée ou live region absente

Cela transforme la screen-reader-testing skill d’un guide généraliste en aide concrète au débogage.

FAQ sur la skill screen-reader-testing

screen-reader-testing suffit-il pour tester l’accessibilité ?

Non. La skill screen-reader-testing couvre une couche importante de test manuel, mais elle doit s’inscrire aux côtés des tests clavier, de la revue du HTML sémantique, des contrôles automatisés et de la revue accessibilité au niveau design. Utilisez-la lorsque vous vous concentrez spécifiquement sur l’expérience avec les technologies d’assistance.

Cette skill est-elle adaptée aux débutants ?

Oui, avec des limites. Elle fournit des priorités de test et des concepts utiles, mais suppose que vous pouvez accéder à de vrais tests — ou les simuler — sur les plateformes concernées. Les débutants peuvent s’en servir pour structurer une revue, mais ils auront peut-être encore besoin d’un accompagnement séparé pour utiliser efficacement NVDA, VoiceOver ou JAWS.

Dans quels cas screen-reader-testing est-il peu adapté ?

Évitez cette skill si votre besoin porte surtout sur :

• le linting automatisé
• le scan de code
• l’accessibilité de produits non web
• une revue UX purement visuelle
• une matrice complète de conformité WCAG

Dans ces cas-là, screen-reader-testing peut soutenir le processus, mais ne doit pas être votre seule méthode.

En quoi est-ce différent d’un prompt accessibilité ordinaire ?

Les prompts ordinaires produisent souvent des conseils très larges. La décision d’installer screen-reader-testing install a du sens lorsque vous voulez un cadre de test réutilisable centré sur le comportement réel des lecteurs d’écran, la priorisation de couverture et un déroulé d’audit concret. Cela réduit l’incertitude sur ce qu’il faut tester d’abord et sur les combinaisons qui comptent le plus.

Puis-je utiliser screen-reader-testing pour une revue design ?

Oui, mais indirectement seulement. La skill est la plus efficace sur des interfaces implémentées ou des prototypes réalistes, lorsque l’ordre de navigation, les labels, les annonces et les changements d’état peuvent être évalués. Pour une revue design en amont, servez-vous-en pour mettre les patterns d’interaction à l’épreuve avant le développement.

Comment améliorer la skill screen-reader-testing

Donner un périmètre plus étroit à la skill screen-reader-testing pour de meilleurs résultats

La façon la plus rapide d’améliorer la qualité de sortie de screen-reader-testing est de réduire l’ambiguïté. Demandez-lui d’examiner un seul parcours, un seul ensemble de plateformes et une seule catégorie de problèmes à la fois. « Audite notre app » est trop large. « Test our account recovery flow for VoiceOver + Safari focusing on heading structure, field instructions, error messaging, and confirmation announcements » est bien plus efficace.

Fournir le comportement attendu, pas seulement l’interface actuelle

Si vous indiquez à l’agent ce que les utilisateurs doivent pouvoir faire, les constats deviennent plus précis. Incluez des attentes telles que :

• le focus doit entrer dans la modal à l’ouverture
• le récapitulatif d’erreurs doit être annoncé après la soumission
• la fin du chargement doit être exposée sans obliger à renaviguer

Cela aide le guide screen-reader-testing à distinguer les bugs d’implémentation des variations sans impact réel.

Inclure l’inventaire des composants et les détails des widgets custom

Les contrôles UI custom sont souvent là où les problèmes de lecteur d’écran se concentrent. Si votre page utilise :

• des menus select custom
• des systèmes d’onglets
• des sections extensibles
• des alternatives au drag-and-drop
• des dashboards avec mises à jour en direct

mentionnez-les explicitement. La skill pourra alors cibler les patterns les plus risqués au lieu de perdre du temps sur du contenu statique à faible risque.

Demander les modes de défaillance et les états limites

Ne limitez pas les tests au happy path. Pour améliorer l’utilité de screen-reader-testing usage, demandez des vérifications sur :

• résultats vides
• saisie invalide
• avertissements d’expiration de session
• contrôles désactivés
• mises à jour asynchrones
• changements de route dans les single-page apps

Ce sont souvent ces états qui révèlent des échecs silencieux que les démos standard ne montrent pas.

Itérer après la première sortie

Après un premier passage, posez des questions de suivi comme :

• « Quels constats sont les plus probablement causés par des noms accessibles incorrects ? »
• « Quels problèmes sont spécifiques à VoiceOver et lesquels sont communs à plusieurs lecteurs d’écran ? »
• « Que faut-il retester après correction de la gestion du focus ? »
• « Quels constats bloquent l’exécution d’une tâche, et lesquels créent seulement de la confusion ? »

Vous transformez ainsi un audit statique en workflow de remédiation priorisé.

Associer screen-reader-testing à une capture de preuves

Pour les équipes, la meilleure amélioration consiste à documenter :

• l’URL exacte de la page ou le build concerné
• la version du lecteur d’écran et du navigateur
• le parcours de navigation
• les touches ou gestes utilisés
• le texte exact de l’annonce observée

Même si la skill elle-même reste textuelle, demander cette structure rend la sortie beaucoup plus facile à vérifier et à transmettre.

Connaître la principale limite avant de s’y fier

La plus grande contrainte est que la skill screen-reader-testing apporte surtout du guidage, avec très peu de support côté dépôt. Il n’y a dans ce dossier ni scripts, ni références, ni assistants d’automatisation fournis. Sa valeur dépend donc de la qualité du contexte que vous fournissez et de la rigueur avec laquelle vous exécutez le plan de test manuel.

Faire évoluer votre prompt de générique à prêt pour l’audit

Un prompt final de haute qualité inclut généralement :

• le produit et le parcours
• les couples lecteur d’écran / navigateur cibles
• les composants prioritaires
• les états à tester
• le format de sortie
• le modèle de sévérité

Exemple :

« Use the screen-reader-testing skill to perform a UX audit of our billing settings flow. Prioritize NVDA + Firefox and VoiceOver + Safari. Test heading navigation, landmark clarity, form labels, inline validation, success and error announcements, dialog focus trapping, and dynamic plan-price updates. Return a table with issue, severity, affected AT/browser, reproduction steps, observed behavior, expected behavior, and likely code-level cause. »

C’est ce niveau de précision qui rend la skill réellement plus utile qu’une demande générique sur l’accessibilité.