| name | skill-conformity-checker |
| description | Valide la conformite structurelle d'un SKILL.md (standards Anthropic, score /50, deterministe). Utiliser quand l'utilisateur dit "verifie ce skill" ou "check skill". Pour l'evaluation semantique, utiliser /skill-review. |
| allowed-tools | Bash, Read, Glob |
| argument-hint | [skill à auditer] |
| disable-model-invocation | true |
Skill : /skill-conformity-checker
Validation structurelle des skills Claude selon les standards Anthropic. Score sur 50 points, 100% déterministe et reproductible (±0 entre deux exécutions).
Déclencheurs
- "/skill-conformity-checker", "vérifie ce skill", "check skill"
- "audit de conformité", "ce skill est-il conforme"
- Toute demande de validation structurelle d'un SKILL.md avant publication
Workflow
Le processus suit 3 phases séquentielles :
- Collecter le chemin du skill à auditer
- Exécuter la validation structurelle (script Python)
- Produire le rapport
Phase 1 : Identification du skill
Déterminer le chemin via $ARGUMENTS ou interaction :
Entrée : /skill-conformity-checker .claude/skills/pdf/SKILL.md
-> chemin = .claude/skills/pdf/SKILL.md
Entrée : /skill-conformity-checker pdf
-> chemin = .claude/skills/pdf/SKILL.md (résolution par nom)
Résolution par nom :
Si $ARGUMENTS ne contient pas de "/" ni de ".md", chercher dans :
.claude/skills/$ARGUMENTS/SKILL.md
Si aucun match, demander à l'utilisateur de préciser le chemin.
- Si l'utilisateur fournit un chemin : l'utiliser directement
- Si l'utilisateur nomme un skill : chercher dans
.claude/skills/{nom}/SKILL.md
- Si aucun chemin : demander à l'utilisateur
Phase 2 : Validation structurelle (50 pts)
Exécuter le script de validation programmatique :
python3 scripts/check_structure.py <chemin-du-skill> --json
Le script vérifie 15 critères déterministes (frontmatter, structure, ressources) et produit un score sur 50. Le résultat est 100% reproductible entre deux exécutions.
Consulter references/criteres-conformite.md pour le détail des critères S01-S15.
Phase 3 : Rapport
Produire le rapport au format suivant :
## Score structurel : XX/50
## Verdict : [Conforme|Acceptable|Non conforme|Rejet]
## Points conformes
- [liste des critères OK]
## Violations
| Sévérité | ID | Critère | Score | Action corrective |
|----------|----|---------|-------|-------------------|
| CRITIQUE | Sxx | ... | 0/N | ... |
| MAJEUR | Sxx | ... | X/N | ... |
## Actions correctives prioritaires
1. [action la plus urgente]
2. [action suivante]
Version des critères : 2.0.0
Note : pour une évaluation sémantique (qualité de la description,
exemples, cohérence), utiliser /skill-review.
Gestion des erreurs
| Scénario | Comportement |
|---|
Script check_structure.py introuvable | Signaler l'erreur et indiquer le chemin attendu (scripts/check_structure.py) |
| Fichier SKILL.md absent dans le dossier | Le script retourne exit code 2 — signaler l'absence et arrêter l'audit |
| Frontmatter YAML invalide (syntaxe cassée) | Le script détecte l'erreur — afficher le message YAML et continuer avec score frontmatter = 0 |
| Dossier skill inexistant | Afficher "Dossier introuvable" et demander le bon chemin |
Si le script retourne exit code 2 (erreur critique), signaler immédiatement.
Exemples d'utilisation
Utilisateur : vérifie le skill /pdf
Claude :
> Phase 1 : Skill identifié — .claude/skills/pdf/
> Phase 2 : Validation structurelle...
> Score : 46/50 (0 critique, 1 majeur, 0 mineur)
> Violations :
> MAJEUR S04 (0/2) — Description sans conditions de déclenchement
> Verdict : Conforme
Utilisateur : audit de conformité de /transfer
Claude :
> Phase 1 : Skill identifié — .claude/skills/transfer/
> Phase 2 : Validation structurelle...
> Score : 29/50 (1 critique, 1 majeur, 1 mineur)
> Violations :
> CRITIQUE S01 (0/3) — Frontmatter YAML absent
> MAJEUR S09 (0/4) — README.md présent dans le dossier
> MINEUR S10 (1/3) — 16 titres H1
> Verdict : Non conforme
> Actions correctives :
> 1. Ajouter un frontmatter YAML avec name et description
> 2. Supprimer le README.md du dossier
Seuils de verdict
| Score | Verdict |
|---|
| 45-50 | Conforme — prêt pour production |
| 35-44 | Acceptable — corrections mineures recommandées |
| 25-34 | Non conforme — corrections requises |
| < 25 | Rejet — refonte nécessaire |
Contraintes
- TOUJOURS exécuter le script check_structure.py (pas d'évaluation manuelle des critères structurels)
- TOUJOURS indiquer la version des critères dans le rapport
- TOUJOURS renvoyer vers
/skill-review pour l'évaluation sémantique
- JAMAIS modifier le fichier audité
- JAMAIS attribuer un verdict "Conforme" si un critère CRITIQUE est en échec
Checklist finale
