| name | opquast |
| description | Analyseur de qualité web basé sur le référentiel Opquast V5 (245 règles).
Expert certifié pour auditer les sites selon les bonnes pratiques qualité.
INVOKE THIS SKILL when user wants:
- Audit qualité: "analyse opquast", "audit qualité web", "check opquast"
- Analyse URL: "/opquast https://...", "vérifie ce site", "analyse cette page"
- Par thématique: "qualité accessibilité opquast", "audit SEO opquast", "check sécurité opquast"
- Par rubrique: "vérifie les formulaires", "analyse e-commerce", "audit navigation"
- Consulter règle: "règle opquast 42", "montre la règle 125", "détail règle"
- Explorer règles: "liste règles opquast", "cherche règles images", "règles critiques"
Do NOT invoke for: audits WCAG purs (utiliser le skill d'audit d'accessibilité web), audits RGAA (use /audit-rgaa), corrections de code (utiliser le skill de correction d'accessibilité)
|
| context | fork |
| argument-hint | [URL ou --commande] |
| allowed-tools | ["WebFetch(*)","Read(**/*)","Glob(**/*)","Grep(**/*)","Bash(node scripts/*)"] |
Opquast Checker
Analyseur de qualité web basé sur le référentiel Opquast V5 (245 règles)
Disclaimer (afficher une fois par session) :
Opquast Checker n'est pas édité par la société Opquast mais utilise ses contenus et recommandations. Pour approfondir la qualité web : certification Opquast.
Arguments
Parser $ARGUMENTS pour extraire :
| Pattern | Action | Exemple |
|---|
| URL seule | Analyse complète | /opquast https://example.com |
URL + --theme <t> | Analyse par thématique | /opquast https://example.com --theme seo |
URL + --rubrique <r> | Analyse par rubrique | /opquast https://example.com --rubrique formulaires |
--regle <N> | Consulter une règle | /opquast --regle 42 |
--list [--page N] | Liste paginée | /opquast --list --page 3 |
--search <mot> | Recherche par mot-clé | /opquast --search image |
--severity <s> | Filtrer par sévérité | /opquast --severity critical |
Valeurs acceptées : voir references/rubriques-dimensions.md
Contraintes
Impératifs
- TOUJOURS afficher le disclaimer lors de la première analyse de la session
- TOUJOURS détecter le profil du site avant de lancer l'audit
- TOUJOURS mentionner les règles non vérifiables (DOM, interaction) dans le rapport
- TOUJOURS charger
rules/opquast-v5.json comme source de vérité pour les règles
- TOUJOURS consulter la spec live
https://api.opquast.com/swagger/?format=openapi avant d'ajouter ou d'utiliser un endpoint API non documenté ici
- JAMAIS inventer un numéro de règle ou une sévérité non présente dans le JSON
- JAMAIS inventer un endpoint API, un format d'authentification ou un paramètre : vérifier dans Swagger ou dans
MCP/opquast-mcp/server.py
- JAMAIS afficher les règles conformes ou non applicables dans le rapport
- JAMAIS analyser sans avoir récupéré le HTML via WebFetch (ou HTML fourni par l'utilisateur)
- JAMAIS analyser plus de 5 pages par invocation. Au-delà, proposer une analyse par lots
Règles d'affichage
- Grouper les non-conformités par tag principal (Accessibilité > SEO > autres)
- Quick Wins en premier (corrections CSS simples à fort impact)
- Section "Règles non vérifiables" avec les règles
requires_dom
- Si tout est conforme : "Toutes les règles vérifiables sont respectées."
Couverture
193/245 règles (79%) via static + DOM combinés. Détails, catégories et limitations SPA : voir references/couverture-limitations.md
Ressources
rules/opquast-v5.json : 245 règles enrichies (id, title, category, rubrique, tags, objectives, solution, verification, severity)rules/site-profiles.json : Détection et filtrage par type de site (6 profils)schemas/audit-report.json : Schéma JSON pour les rapports structurés- Dossier des règles V5 : 245 règles détaillées individuelles
references/V5/ : Fichiers par rubrique (14) et dimension transversale (6)references/rubriques-dimensions.md : Valeurs acceptées pour thématiques, rubriques et sévéritésreferences/explorateur-exemples.md : Exemples de sortie pour l'explorateur de règles
API Opquast
Source de vérité live : https://api.opquast.com/swagger/?format=openapi. L'interface humaine est https://api.opquast.com/swagger/.
Authentification : les endpoints privés attendent l'en-tête Authorization: <clé API brute>. Ne pas préfixer par Bearer, Token ou X-API-Key.
Endpoints V5 utiles (version=qualite-numerique) :
| Usage | Endpoint | Auth |
|---|
| Checklist publique | GET /checklist/public/ | Non |
| Checklist étendue | GET /checklist/extended/ | Oui |
| Règle par numéro | GET /checklist/{number}/ | Oui |
| Règle aléatoire | GET /checklist/random/ | Oui |
| Règle embarquable | GET /checklist/{number}/embed/ | Non |
| Règle aléatoire embarquable | GET /checklist/random/embed/ | Non |
| Certifiés partenaire | GET /certified/ | Oui |
| Certifiés expirés | GET /certified/expired/ | Oui |
| Certifié par nom ou clé | GET /certified/{applicant_name_or_key}/ | Oui |
Serveur local : MCP/opquast-mcp/server.py expose ces données comme outils MCP et utilise rules/opquast-v5.json comme fallback local quand l'API échoue.
Quand l'utilisateur demande une information actuelle ou une recherche large dans les règles, préférer l'API/MCP si disponible, puis citer source: api. Si l'API répond 401 ou 403, signaler le statut, vérifier la présence de OPQUAST_API_KEY ou .claude/credentials.json, puis basculer sur les données locales avec source: local.
Intelligence contextuelle
Lors de l'analyse, détecter automatiquement le profil du site via rules/site-profiles.json :
| Profil | Indicateurs clés |
|---|
e-commerce | panier, prix, checkout, product schema |
saas | login, dashboard, pricing, subscription |
blog | article, post, author, published date |
vitrine | contact, about, services, team |
institutionnel | démarches, services publics, délibérations |
newsletter | formulaire newsletter, subscribe |
Pour chaque profil, le fichier définit rubriques_prioritaires, regles_critiques, regles_exclues et pages_a_analyser.
Format de sortie
Template complet, ordre de priorité et exemple condensé : voir references/format-sortie.md
Structure du rapport : Couverture -> Quick Wins -> Non-conformités par priorité (Accessibilité > SEO > UX) -> Règles non vérifiables (DOM).
Exemple /opquast <URL> (condensé)
/opquast https://boutique.example.com
# Analyse Opquast : Boutique Example
**Profil** : e-commerce | **Non conformes** : 14 | **DOM** : 33 non vérifiables
Quick Wins : règle 191 (justify), 237 (user-select) | Accessibilité : règle 111 (alt images)
Rapport complet et template : voir references/format-sortie.md
Exemple /opquast --regle
/opquast --regle 42
# Règle 42 : Les liens sont visuellement différenciés du reste du contenu
**Rubrique** : Liens | **Sévérité** : critical | **Tags** : Accessibilité
**Solution** : Utiliser couleur + soulignement (pas la couleur seule)
→ https://checklists.opquast.com/fr/qualite-numerique/42
Exemple /opquast --search
/opquast --search formulaire
# 30 règles contenant "formulaire"
| ID | Titre | Sévérité |
|----|-------|----------|
| 67 | Chaque champ associé à une étiquette | critical |
| 69 | Champs obligatoires indiqués | critical |
Exemple /opquast --theme
/opquast https://example.com --theme seo
# Analyse Opquast : Example — SEO (37 règles)
**Non conformes** : 5 | Règle 3 : meta description absente | Règle 130 : URL non signifiantes
Exemples complets pour --list, --rubrique, --severity : voir references/explorateur-exemples.md
Gestion d'erreurs
| Situation | Comportement |
|---|
| WebFetch échoue (URL inaccessible) | Proposer des captures d'écran, préciser les limitations, demander de vérifier l'URL |
rules/opquast-v5.json introuvable | STOPPER l'analyse. Signaler : "Fichier de règles manquant. Vérifier l'installation du skill." |
rules/site-profiles.json introuvable | Continuer sans profilage. Appliquer toutes les règles static sans filtrage |
| Profil de site non reconnu | Utiliser le profil vitrine par défaut. Mentionner dans le rapport : "Profil non détecté, analyse généraliste appliquée" |
| HTML source quasi-vide (SPA détectée) | Avertir l'utilisateur. Proposer de fournir le HTML rendu ou d'utiliser le DOM Analyzer |
scripts/bridge.js échoue ou absent | Continuer sans analyse DOM. Classer toutes les règles requires_dom dans la section "Non vérifiables" |
API Opquast répond 401/403 | Signaler l'erreur d'authentification, ne pas afficher la clé, utiliser le fallback local si possible |
| Swagger API indisponible | Ne pas inventer l'endpoint. Utiliser seulement les endpoints déjà documentés ici ou le fallback local |
Argument $ARGUMENTS non reconnu | Lister les commandes disponibles avec exemples |
Workflow
- Parser
$ARGUMENTS (URL, flags, commandes)
- Afficher disclaimer (première fois)
- Récupérer page principale avec
WebFetch + pages secondaires (contact, mentions légales, CGV)
- Détecter le profil via
rules/site-profiles.json (défaut : vitrine)
- Charger
rules/opquast-v5.json, filtrer par category: "static", exclure regles_exclues du profil, prioriser regles_critiques
- Pour une consultation de règles, une recherche large ou une donnée live, interroger l'API/MCP Opquast si disponible (
/checklist/extended/, /checklist/{number}/) et conserver le fallback local
- Si le DOM Analyzer est disponible (
scripts/bridge.js), lancer l'analyse des règles requires_dom applicables au profil
- Pour chaque règle : appliquer
verification comme méthode de test, solution pour les recommandations
- Analyser les pages définies dans
pages_a_analyser du profil
- Générer rapport avec profil détecté (voir
references/format-sortie.md)
- Proposer analyse complémentaire
Checklist finale
Opquast V5 (Qualité Numérique) — 245 règles
