Auditer l'accessibilité d'une interface web
L'équipe de développement soumet des extraits de code front-end ou des rapports d'outils automatisés pour vérifier l'accessibilité numérique d'une application. Le skill identifie les manquements aux critères du RGAA et propose des correctifs techniques précis.
Télécharger le skill (.zip) Guide d'installation
Objectif
L'équipe de développement soumet des extraits de code front-end ou des rapports d'outils automatisés pour vérifier l'accessibilité numérique d'une application. Le skill identifie les manquements aux critères du RGAA et propose des correctifs techniques précis.
Méthode : Le skill analyse le code fourni en le confrontant aux thématiques du RGAA telles que les images, les couleurs, les scripts et les éléments obligatoires. Il repère les attributs ARIA manquants, les défauts de contraste et la mauvaise structuration sémantique des balises. En cas de données visuelles non interprétables, il signale explicitement les critères nécessitant une vérification manuelle. Il formule ensuite des propositions de code de remplacement pour chaque non-conformité technique détectée.
Entrées acceptées
Ce que vous obtenez
Limites et supervision humaine
Ce skill produit une aide de travail qui doit être relue et validée par un humain avant toute décision, diffusion ou dépôt.
Limite principale : L'analyse par IA ne remplace pas un audit manuel complet par un expert certifié RGAA, notamment pour les tests de navigation au clavier ou l'utilisation de lecteurs d'écran. Les recommandations doivent être systématiquement testées et validées par un développeur avant tout déploiement en production.
Il distingue les faits, les calculs et les hypothèses, n'invente aucune donnée et signale ce qui reste à confirmer.
Sources officielles
Références utilisées pour cadrer la méthode. Vérifiez leur version à la date d'utilisation.
Aperçu du SKILL.md
Premières lignes du fichier embarqué dans l'archive — le contrat d'exécution du skill.
---
name: auditer-accessibilite-interface-web
description: L'équipe de développement soumet des extraits de code front-end ou des rapports d'outils automatisés pour vérifier l'accessibilité numérique d'une application. Le skill identifie les manquements aux critères du RGAA et propose des correctifs techniques précis.
---
# Auditer l'accessibilité d'une interface web
## Mission
Auditer l'accessibilité numérique front-end d'une interface web en analysant le code source ou les rapports d'outils automatisés, identifier les manquements aux critères du RGAA et formuler des propositions de code de remplacement pour chaque non-conformité technique détectée.
## Résultat attendu
Un rapport d'audit d'accessibilité structuré comprenant une grille partielle, la liste des anomalies détectées, des recommandations de code correctif précises et un plan d'action priorisé.
## Situations d'usage
L'équipe de développement soumet des extraits de code front-end ou des rapports d'outils automatisés (Axe, Lighthouse) pour vérifier l'accessibilité numérique d'une application avant déploiement.
## Ce que le skill ne fait pas
- Il ne remplace pas un audit manuel complet par un expert certifié RGAA.
- Il ne réalise pas de tests de navigation au clavier.
- Il ne vérifie pas l'utilisation avec des lecteurs d'écran.
- Il ne traite pas la revue de code standard, les tests fonctionnels ou la gestion des logs.
## Entrées obligatoires
- Extraits de code source (HTML/CSS/JS) ou rapports d'outils d'accessibilité (Axe, Lighthouse).
## Entrées facultatives
- Spécifications fonctionnelles de l'interface.
- Charte graphique (pour l'évaluation des contrastes).
## Validation préalable
- Vérifier la présence de code source ou de rapports d'outils dans les entrées.
- Si les données visuelles ne sont pas interprétables, le signaler explicitement.
## Méthodologie
1. **Analyser** le code fourni en le confrontant aux thématiques du RGAA (images, couleurs, scripts, éléments obligatoires, etc.).
2. **Repérer** les attributs ARIA manquants, les défauts de contraste et la mauvaise structuration sémantique des balises.
3. **Signaler** explicitement les critères nécessitant une vérification manuelle en cas de données visuelles non interprétables.
4. **Formuler** des propositions de code de remplacement pour chaque non-conformité technique détectée.
5. **Structurer** le livrable selon le modèle défini.
## Règles de décision
- Toute non-conformité détectée doit être accompagnée d'une proposition de code correctif.
- Les critères nécessitant une vérification visuelle ou manuelle doivent être clairement isolés et signalés.
- Ne jamais inventer de conformité si le code fourni ne permet pas de statuer.
## Contrôles qualité
- Le rapport contient les quatre sections attendues (grille, anomalies, correctifs, plan d'action).
- Les propositions de code sont techniquement valides et répondent au critère RGAA ciblé.
- Les limites de l'analyse automatisée sont rappelées.
- Les calculs de contraste (le cas échéant) explicitent les formules, unités et données manquantes.
## Format de sortie
Le livrable doit respecter le modèle défini dans `templates/auditer-accessibilite-interface-web-output.md` et inclure :
1. Grille d'audit d'accessibilité partielle.
2. Liste des anomalies détectées.
3. Recommandations de code correctif.
4. Plan d'action priorisé.
## Convention de confiance
- **Faits observés** : Extraits de code analysés, défauts sémantiques ou attributs manquants.
- **Données calculées** : Ratios de contraste (si calculables).
- **Anomalies** : Critères RGAA non respectés.
- **Recommandations** : Code correctif proposé.
- **Validation humaine requise** : Toute décision de conformité finale, test de navigation au clavier, et validation par un développeur avant déploiement.
## Gestion des erreurs
- Si le code fourni est insuffisant pour l'analyse : demander des extraits complémentaires.
- Si les rapports d'outils sont illisibles : demander un format textuel ou JSON valide.
- Si des données visuelles sont nécessaires mais absentes : lister les vérifications manuelles à effectuer.
## Limites
- L'analyse par IA ne remplace pas un audit manuel complet par un expert certifié RGAA.
- Les recommandations doivent être systématiquement testées et validées par un développeur avant tout déploiement en production.
- Toute décision réglementaire, juridique, de sécurité ou de conformité requiert une validation humaine.
## Exemple
Demande : "Vérifie l'accessibilité de ce composant de menu de navigation (code HTML/JS fourni)."
Traitement : Analyse sémantique (balises `<nav>`, `<ul>`, `<li>`), vérification des attributs ARIA (`aria-expanded`, `aria-haspopup`), contrôle de la gestion du focus en JS. Signalement des défauts de contraste à vérifier manuellement si le CSS n'est pas fourni. Proposition de code HTML/JS corrigé avec les attributs ARIA appropriés. Rappel de la nécessité de tester au clavier.
## Protocole de traçabilité
Pour chaque donnée utilisée, conserver le nom du document, sa date, la rubrique consultée et le passage utile. Pour chaque calcul, indiquer la formule, les valeurs d'entrée, l'unité, la règle d'arrondi et le résultat. Si plusieurs documents se contredisent, ne pas choisir silencieusement : présenter les versions, expliquer l'impact et demander un arbitrage. Les sources externes listées dans `references/sources.md` servent de repères ; vérifier leur version et leur date avant usage.
## Dossier de preuve minimal
Le résultat doit permettre à un tiers de comprendre ce qui a été contrôlé sans relire tous les documents. Inclure le périmètre, la période, les pièces reçues, les pièces manquantes, les constats, les preuves associées, les calculs, les hypothèses, les décisions à valider et le nom du responsable de la revue. Pour ce skill, les entrées attendues sont : Extraits de code source (HTML/CSS/JS), Rapports d'outils d'accessibilité (Axe, Lighthouse), Spécifications fonctionnelles de l'interface, Charte graphique (pour les contrastes). Les résultats attendus sont : Grille d'audit d'accessibilité partielle, Liste des anomalies détectées, Recommandations de code correctif, Plan d'action priorisé.
## Checklist finale
- [ ] Le besoin correspond bien au périmètre du skill.
- [ ] Les documents, périodes, versions et unités sont identifiés.
- [ ] Chaque constat important cite une preuve fournie.
Installation
- Téléchargez le fichier. Pour vérifier son intégrité, utilisez
shasum -a 256 auditer-accessibilite-interface-web.zipet comparez le résultat avec l'empreinte affichée dans la fiche technique. - Décompressez-le : vous obtenez un dossier contenant
SKILL.mdet ses ressources. - Importez le dossier dans claude.ai, Claude Code ou via l'API.