RGAA Skill para Claude Code
Isalafont/claude-skill-rgaa-dev
Audite e implemente acessibilidade RGAA/WCAG em Rails + DSFR
Ver no GitHubSkill que implementa assistência para conformidade RGAA 4.1 / WCAG 2.2 AA em projetos Rails com ERB, ViewComponent e Stimulus. Fornece um guia de implementação e auditoria critério por critério, com cobertura parcial de 30-40 dos 106 critérios RGAA através de análise estática do código.
Instalação
npx convez-ai Isalafont/claude-skill-rgaa-dev1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Validar conformidade de componentes Rails com WCAG 2.2 AA
- Detectar atributos ARIA e labels ausentes em formulários e widgets interativos
- Auditar estrutura HTML, hierarquia de títulos e landmarks
- Verificar implementação de DSFR em projetos governamentais franceses
Veredito

Ferramenta sólida e transparente para agilizar a conformidade RGAA em stacks Rails específicas. Fundamental: não substitui testes com leitores de tela e auditoria humana — cobre bem apenas estrutura HTML (30-40% dos critérios). Excelente como assistente contínuo durante desenvolvimento, especialmente para projetos públicos franceses.
README
A tradução para o português deste README ainda está na fila.
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
- Outil d'aide au développement
- Installation
- Utilisation avec Claude Code
- Skills disponibles
- Structure du projet
- Ce que la skill couvre
- Fichiers de référence
- Points clés à retenir
- Obligation légale
- Licence
- Références
- Support
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
Elles se chargent aussi quand tu travailles sur des fichiers ERB, ViewComponent
ou JavaScript (via le champ paths du frontmatter). Dans ce mode, Claude
applique les règles sans que tu aies à les mentionner.
Mode explicite
Pour demander un audit ou poser une question ciblée :
/accessibility:rgaa-dev Quelles règles ARIA pour une liste avec filtre dynamique ?
/accessibility:rgaa-dev Implémente un champ upload accessible RGAA
/accessibility:rgaa-dev Ce formulaire est-il conforme RGAA 11 ?
/accessibility:audit app/views/users/show.html.erb
/accessibility:audit app/components/form/search_filter_component.html.erb
Cas d'usage typiques
| Situation | Ce que tu demandes |
|---|---|
| Code review | /accessibility:rgaa-dev Vérifie ce composant |
| Nouveau composant | Demander l'implémentation normalement — Claude suit les règles |
| Audit d'une page | /accessibility:audit app/views/foo.html.erb |
| Question ponctuelle | /accessibility:rgaa-dev Comment gérer le focus dans une modale Turbo ? |
| Correction d'erreur axe | /accessibility:rgaa-dev axe remonte "aria-required-children" sur ce code |
Skills disponibles
Ce plugin accueille plusieurs skills complémentaires :
| Skill | Invocation | Statut | Description |
|---|---|---|---|
| Guide RGAA/WCAG | /accessibility:rgaa-dev | ✅ Disponible | Guide complet d'implémentation — HTML sémantique, ARIA, Rails, DSFR |
| Audit guidé | /accessibility:audit | ✅ Disponible | Audit critère par critère — Rails/ERB/ViewComponent uniquement — corrections DSFR prêtes à l'emploi |
| Checklist commit | /accessibility:check | 🚧 En conception | Checklist rapide avant commit/merge |
Périmètre de
/accessibility:audit: conçu pour la stack Rails (ERB, ViewComponent, Stimulus, DSFR). Pour un projet Next.js / React (JSX/TSX), utilise le skill communautaireetalab-ia/skills—npx skills add etalab-ia/skills --skill rgaa -a claude-code.
Structure du projet
claude-skill-rgaa-dev/
│
├── README.md # Ce fichier
├── LICENSE.md # Licence Ouverte 2.0 (Etalab)
├── install.sh # Script d'installation manuelle
│
├── .claude-plugin/
│ ├── plugin.json # Métadonnées du plugin Claude Code
│ └── marketplace.json # Configuration du marketplace rgaa-toolkit
│
├── templates/ # Templates pour futurs skills
│
└── skills/ # Skills disponibles
├── rgaa-dev/ # Guide d'implémentation
│ ├── SKILL.md # Point d'entrée — règles d'or, anti-patterns
│ ├── examples-dsfr.md # Exemples HTML avec classes DSFR
│ ├── examples-html.md # Référence universelle HTML/WCAG/ARIA
│ ├── checklist.md # Checklists par type de page
│ ├── rails-patterns.md # Patterns Rails / ERB / ViewComponent / Stimulus / Turbo
│ ├── colors.md # Contrastes, tokens DSFR, outils
│ ├── fallbacks.md # Alternatives en cas de charge disproportionnée
│ ├── html-structure.md # Validation HTML, titres, landmarks
│ ├── resources.md # Liens RGAA par critère, outils, déclaration
│ ├── impacts.md # Impact par type de handicap + priorités
│ └── rgaa-themes.md # Les 13 thèmes RGAA détaillés
│
└── audit/ # Méthodologie d'audit guidé
├── SKILL.md # Point d'entrée — analyse statique, questions runtime, format rapport
└── references/ # Critères RGAA détaillés par groupe de thèmes
├── images-cadres-couleurs.md
├── multimedia-tableaux-liens-scripts.md
├── structure-presentation.md
├── formulaires.md
└── navigation-consultation.md
Ce que la skill couvre
Standards
- RGAA 4.1.2 — standard légal français (obligatoire pour les services publics)
- WCAG 2.2 AA — niveaux A et AA (baseline légale EAA depuis juin 2025)
- WAI-ARIA 1.2 — patterns d'interaction (combobox, dialog, tabs, accordion…)
- DSFR — Système de Design de l'État (composants, classes, helpers)
- HTML ARIA conformance — W3C
Thèmes RGAA couverts
Thèmes 1 à 13 : images, cadres, couleurs, multimédia, tableaux, liens, scripts, éléments obligatoires, structuration, présentation, formulaires, navigation, consultation.
Stack technique
- Rails ERB + helpers ARIA
- DSFRFormBuilder
- ViewComponents (Atomic Design)
- Stimulus controllers (toggle, modal, live region, listbox)
- Turbo Drive / Frames / Streams
- Tests axe-core (Cucumber + RSpec)
Fichiers de référence
Skill rgaa-dev — guide d'implémentation
| Fichier | Contenu |
|---|---|
SKILL.md | Point d'entrée — règles d'or, arbre de décision, anti-patterns |
examples-dsfr.md | Exemples HTML avec classes DSFR (contexte DataPass) |
examples-html.md | Référence universelle HTML/WCAG/ARIA (sans framework) |
checklist.md | Checklists par type de page (formulaire, liste, composants dynamiques, zoom 200 %) |
rails-patterns.md | Patterns Rails / ERB / ViewComponent / Stimulus / Turbo |
colors.md | Contrastes, tokens DSFR, outils de test |
fallbacks.md | Alternatives quand l'idéal est impossible — charge disproportionnée, PDF, vidéo, composants tiers |
html-structure.md | Validation HTML, titres, landmarks, snippets DevTools |
resources.md | Liens RGAA par critère, outils, déclaration d'accessibilité |
impacts.md | Impact des défauts par type de handicap + priorités |
rgaa-themes.md | Les 13 thèmes RGAA détaillés |
Skill audit — méthodologie d'audit guidé (Rails/ERB uniquement)
| Fichier | Contenu |
|---|---|
SKILL.md | Point d'entrée — analyse statique silencieuse, 3 questions runtime, format rapport |
references/images-cadres-couleurs.md | Critères 1–3 : patterns de détection, NC type, corrections ERB/DSFR |
references/multimedia-tableaux-liens-scripts.md | Critères 4–7 : idem |
references/structure-presentation.md | Critères 8–10 : idem |
references/formulaires.md | Critères 11 : idem |
references/navigation-consultation.md | Critères 12–13 : idem |
Points clés à retenir
Anti-patterns fréquents que la skill corrige :
role="alert"+aria-live="assertive"→ redondant,role="alert"suffit<div onclick>→ utiliser<button>ou<a>tabindex="2"→ ne jamais utiliser tabindex > 0alt=""+role="presentation"→alt=""suffit pour une image décorative- placeholder comme seul label → toujours un
<label>visible
Règle des 5 ARIA (W3C) :
- Utiliser le HTML natif en premier (pas d'ARIA si un élément sémantique existe)
- Ne pas modifier la sémantique native inutilement
- Tous les contrôles ARIA doivent être utilisables au clavier
- Les éléments focusables avec rôle/état/propriété visibles
- Les éléments interactifs ont un nom accessible
Obligation légale
Tout service numérique public → la conformité RGAA est obligatoire (loi 2005-102, décret 2019-768).
L'European Accessibility Act rend WCAG 2.2 AA obligatoire dans l'UE depuis le 28 juin 2025.
Cela implique :
- Publier une déclaration d'accessibilité accessible depuis le footer (
/accessibilite) - Maintenir un schéma pluriannuel mis à jour annuellement
- Viser 50 % minimum des critères RGAA applicables (niveau « partiellement conforme »)
Générateur officiel de déclaration : https://betagouv.github.io/a11y-generateur-declaration/
Licence
Ce projet est publié sous Licence Ouverte 2.0 (Etalab-2.0).
Droits : réutilisation libre et gratuite, y compris à des fins commerciales.
Obligation : mentionner la paternité (source + date de mise à jour).
Compatibilité : CC-BY, OGL (UK), ODC-BY.
Références
- RGAA 4.1.2 — référentiel officiel
- WCAG 2.2 — standard international
- WAI-ARIA 1.2 — patterns ARIA
- Design System Français (DSFR)
- dsfr-skill — skill Claude Code pour les 23 composants DSFR
- Générateur de déclaration d'accessibilité
- Licence Ouverte 2.0
Support
Questions ou bugs sur la skill : ouvrir une issue sur ce dépôt.
Questions sur le RGAA :
- Forum RGAA (DISIC)
- Documentation officielle
Version : 1.1.1 | Dernière mise à jour : 2026-04-22