RGAA Skill pour Claude Code
Plugin Claude Code fournissant deux skills d'accessibilité numérique pour les
projets publics français : un guide d'implémentation conforme RGAA 4.1.2 / WCAG 2.2
AA / WAI-ARIA 1.2, et un audit guidé critère par critère. Conçu pour la stack
Rails + ERB + ViewComponent + Stimulus + Turbo, avec ou sans DSFR (détection
automatique du contexte projet).
Outil d'aide au développement
Cette skill assiste à l'implémentation et à la détection de non-conformités dans le code. Elle ne remplace pas un audit humain : sur 106 critères RGAA 4.1.2, l'analyse statique du code en couvre environ 30 à 40 de façon fiable. Les tests lecteur d'écran, navigation clavier et contrastes réels restent indispensables.
Couverture par thème
| Thème RGAA | Couverture IA |
|---|
| 1 — Images | 🟡 Partielle — détecte alt manquant et aria-hidden, ne juge pas la pertinence du texte |
| 2 — Cadres | 🟡 Partielle — détecte title manquant sur <iframe> |
| 3 — Couleurs | 🟠 Limitée — vérifie l'usage des tokens DSFR, pas les contrastes calculés au runtime |
| 4 — Multimédia | ❌ Non couverte — nécessite de regarder/écouter le contenu |
| 5 — Tableaux | ✅ Bonne — scope, caption, headers vérifiables statiquement |
| 6 — Liens | 🟡 Partielle — intitulés et aria-label, pas le comportement réel en contexte |
| 7 — Scripts | 🟡 Partielle — ARIA sur composants interactifs, pas la navigation clavier effective |
| 8 — Éléments obligatoires | ✅ Bonne — lang, title, meta vérifiables dans le code |
| 9 — Structuration | 🟡 Partielle — hiérarchie des titres et landmarks dans le code |
| 10 — Présentation | 🟠 Limitée — ne peut pas tester la présentation sans CSS |
| 11 — Formulaires | ✅ Bonne — <label>, messages d'erreur, groupements vérifiables |
| 12 — Navigation | 🟠 Limitée — ne peut pas tester avec un lecteur d'écran |
| 13 — Consultation | ❌ Non couverte — sessions, délais, animations nécessitent des tests runtime |
L'accessibilité numérique, c'est permettre à chacun d'accéder à un service, quelles que soient ses capacités. 15 à 20 % des utilisateurs vivent avec un handicap qui affecte leur navigation numérique — visuel, moteur, auditif ou cognitif. Un service accessible, c'est un service qui fonctionne pour tous.
Pour consulter les 106 critères : accessibilite.numerique.gouv.fr
Table des matières
Installation
Option 1 : Via le système de plugins (recommandée)
Depuis Claude Code :
/plugin marketplace add https://github.com/Isalafont/claude-skill-rgaa-dev
/plugin install accessibility@rgaa-toolkit
accessibility@rgaa-toolkit suit la convention plugin@marketplace : le plugin
s'appelle accessibility, il est publié dans le marketplace rgaa-toolkit.
Une fois installé, il est disponible dans tous tes projets Claude Code via les
skills /accessibility:rgaa-dev et /accessibility:audit.
Pour vérifier l'installation : /plugin liste les plugins actifs.
Pour recharger après une mise à jour : /reload-plugins.
Option 2 : Installation manuelle via Git
Installation globale (disponible partout) :
cd ~/.claude/skills
git clone https://github.com/Isalafont/claude-skill-rgaa-dev.git rgaa-dev
Installation spécifique à un projet :
cd /chemin/vers/votre/projet
mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/Isalafont/claude-skill-rgaa-dev.git rgaa-dev
Via le script fourni (équivalent installation globale) :
git clone https://github.com/Isalafont/claude-skill-rgaa-dev.git
cd claude-skill-rgaa-dev
bash install.sh
Vérifier l'installation
Dans Claude Code, les skills sont actifs si tu peux poser ce genre de questions :
"Quelles règles ARIA pour une liste avec filtre dynamique ?"
"Implémente un champ upload accessible RGAA"
"Audite ce composant avant merge"
Si les skills sont chargés, Claude Code a accès au guide complet et à la
méthodologie d'audit pas-à-pas.
Utilisation avec Claude Code
Mode automatique
Les skills se chargent automatiquement quand tu demandes à Claude de :
- Implémenter un formulaire, un composant interactif ou une navigation
- Gérer le focus, les annonces dynamiques ou les contrastes
- Faire une review ou un audit d'une vue avant merge
- Poser une question sur RGAA, WCAG, ARIA ou le handicap
