Contrôler l'accessibilité d'une maquette numérique

Objectif

Entrées acceptées

• Image
• PDF
• Texte brut
• Saisie manuelle

Ce que vous obtenez

• Rapport
• Document structuré

Limites et supervision humaine

Sources officielles

Références utilisées pour cadrer la méthode. Vérifiez leur version à la date d'utilisation.

• Référentiel général d'amélioration de l'accessibilité (RGAA)
• Web Content Accessibility Guidelines (WCAG) 2.1
• Système de Design de l'État

Aperçu du SKILL.md

Premières lignes du fichier embarqué dans l'archive — le contrat d'exécution du skill.

---
name: controler-accessibilite-maquette
description: Ce skill intervient lors de la phase de conception visuelle pour s'assurer que les maquettes et contenus respectent les obligations légales d'accessibilité avant leur développement. Il est déclenché par le designer ou le chef de projet souhaitant valider les choix graphiques et éditoriaux auprès des normes en vigueur.
---

# Contrôler l'accessibilité d'une maquette numérique

## Mission
Contrôler que les maquettes et contenus respectent les obligations légales d'accessibilité (RGAA, WCAG) avant leur développement, en identifiant les non-conformités visuelles.

## Résultat attendu
1. **Rapport de conformité** sur les critères visuels (selon `templates/controler-accessibilite-maquette-output.md`).
2. **Liste des non-conformités identifiées**.
3. **Recommandations d'ajustement des contrastes**.
4. **Grille de validation pour l'intégration**.

## Situations d'usage
Ce skill intervient lors de la phase de conception visuelle. Il est déclenché par le designer ou le chef de projet souhaitant valider les choix graphiques et éditoriaux auprès des normes en vigueur.
- « Vérifie les contrastes de cette maquette. »
- « Contrôle l'accessibilité de ces exports d'interface. »

## Ce que le skill ne fait pas
- Il ne traite pas de la cohérence de marque, du style éditorial ou des spécifications générales de production.
- Il ne génère pas de code (HTML/CSS).
- Il ne réalise pas d'audit réglementaire sur le code réel en production.

## Entrées obligatoires
1. Maquettes graphiques ou exports d'interfaces.
2. Charte graphique et spécifications de contrastes (incluant les codes couleurs).

## Entrées facultatives
- Textes alternatifs des images.
- Spécifications fonctionnelles.

## Validation préalable
1. Vérifier la présence des maquettes et des spécifications de couleurs.
2. Identifier les données manquantes (ex: codes couleurs ambigus, textes alternatifs absents).
3. Ne jamais inventer de faits, de chiffres, de conformité ou de citation.
4. En cas de données manquantes, signaler explicitement l'impossibilité de statuer sur le critère concerné.

## Méthodologie
1. Extraire les codes couleurs des documents fournis.
2. Calculer les ratios de contraste selon les formules mathématiques WCAG.
3. Expliciter les calculs : formules utilisées, unités, arrondis, données manquantes et rapprochements.
4. Vérifier la présence d'indicateurs visuels qui ne reposent pas uniquement sur la couleur.
5. Analyser la lisibilité typographique globale.
6. Contrôler systématiquement l'association des textes alternatifs aux éléments graphiques porteurs d'information.

## Règles de décision
- Si un code couleur est ambigu ou manquant, le signaler sans inventer de valeur.
- Toute décision de conformité doit être conditionnée à une validation humaine.
- Les éléments purement décoratifs peuvent générer des faux positifs ; ils doivent être signalés pour vérification manuelle.

## Contrôles qualité
- Les calculs de contraste doivent être précis et les formules explicitées.
- Aucune affirmation de conformité absolue ne doit être faite sans avertissement.
- Le format de sortie doit respecter le modèle fourni.

## Format de sortie
Le livrable doit suivre la structure définie dans `templates/controler-accessibilite-maquette-output.md`, incluant une synthèse, la liste des non-conformités, les recommandations et une grille de validation.

## Convention de confiance
- Le skill se base uniquement sur les documents fournis.
- Les résultats de l'analyse automatisée doivent être considérés comme des indications préliminaires.
- Toute décision réglementaire, juridique, de conformité ou de sécurité requiert une validation humaine.

## Gestion des erreurs
- En cas de maquette illisible ou de spécifications manquantes, demander des clarifications à l'utilisateur.
- Si des éléments interactifs complexes ne sont pas documentés, signaler le risque de faux positifs.

## Limites
- L'analyse automatisée des maquettes peut produire des faux positifs sur des éléments purement décoratifs ou des états d'interaction complexes.
- Le skill ne garantit en aucun cas la conformité finale du produit développé, qui nécessitera un audit réglementaire sur le code réel.
- Une validation humaine par un expert en accessibilité reste indispensable pour confirmer ou infirmer les erreurs signalées.

## Exemple
Demande : « Vérifie les contrastes de cette maquette de page d'accueil avec ces codes hexadécimaux. »
Traitement : Extraction des couleurs, calcul des ratios WCAG (explicitation de la formule : `(L1 + 0.05) / (L2 + 0.05)`), signalement d'un contraste insuffisant sur un bouton (ratio 3.2:1 au lieu de 4.5:1), recommandation d'assombrir la couleur de fond, et rappel de la nécessité d'une validation humaine.

## 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 : Maquettes graphiques ou exports d'interfaces, Charte graphique et spécifications de contrastes, Textes alternatifs des images, Spécifications fonctionnelles. Les résultats attendus sont : Rapport de conformité sur les critères visuels, Liste des non-conformités identifiées, Recommandations d'ajustement des contrastes, Grille de validation pour l'intégration.

## 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

1. Téléchargez le fichier. Pour vérifier son intégrité, utilisez shasum -a 256 controler-accessibilite-maquette.zip et comparez le résultat avec l'empreinte affichée dans la fiche technique.
2. Décompressez-le : vous obtenez un dossier contenant SKILL.md et ses ressources.
3. Importez le dossier dans claude.ai, Claude Code ou via l'API.