Chapter 3 · Rendre ton skill fiable
Ajouter des modèles, puis tester et corriger
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLe pourquoi
Certaines choses sont trop longues pour tenir dans les étapes : ta grille de tarifs, ton modèle de devis, trois légendes que tu as adorées. Tu peux les ranger dans le dossier du skill, à côté du SKILL.md.
Exemple : Thomas, menuisier, veut que ses devis gardent toujours la même présentation. Il range son modèle dans modele-devis.md et ses prix dans tarifs.md. Le skill dit : « utilise le modèle, prends les prix uniquement dans tarifs.md ». Plus aucun prix inventé.
Ranger des fichiers dans le dossier du skill
La documentation officielle le prévoit : un skill peut contenir d'autres fichiers, que le SKILL.md cite. Claude ne les lit que quand il en a besoin.
devis/
SKILL.md (obligatoire)
modele-devis.md (la présentation à suivre)
tarifs.md (tes prix, écrits par toi)
exemples.md (un ou deux devis réussis)
Les skills du pack font pareil : carrousel-fige contient un gabarit de slide et un script de rendu, site-vitrine contient un modèle de brief.
Dans le SKILL.md, cite chaque fichier et dis quand le lire :
## Fichiers du skill
- `modele-devis.md` : la présentation exacte du devis. Suis-la à la lettre.
- `tarifs.md` : les seuls prix autorisés. Si une prestation n'y est pas, écris [prix à compléter].
- `exemples.md` : deux devis réussis, pour le ton et le niveau de détail.
Pour les scripts, la documentation indique une variable qui donne le chemin du dossier du skill, ${CLAUDE_SKILL_DIR}. Pour un premier skill sans script, tu n'en as pas besoin.
La documentation recommande aussi de garder le SKILL.md sous 500 lignes : ce qui est long va dans les fichiers annexes.
Le bloc à copier : un fichier d'exemples
Crée exemples.md dans le dossier de ton skill :
# Exemples réussis
## Exemple 1
Demande : [la demande que tu avais faite]
Résultat que j'ai gardé :
[colle le résultat]
Pourquoi il est bon : [ex. accroche courte, un seul émoji, horaires à la fin]
## Exemple 2
Demande : [...]
Résultat que j'ai gardé :
[...]
Pourquoi il est bon : [...]
Puis ajoute dans le SKILL.md : « Avant d'écrire, lis exemples.md et inspire-toi du ton et de la longueur, sans recopier. »
Tester ton skill comme un pro
Un test, c'est une série de demandes que tu rejoues après chaque modification. Garde-la dans un fichier tests.txt (pour toi, pas pour Claude).
Tests du skill [nom] :
1. Demande normale : [ex. /legende-instagram croissants du dimanche]
2. Demande sans le / : [ex. écris-moi un texte de post pour nos croissants]
3. Demande incomplète : [ex. /legende-instagram] (doit poser UNE question)
4. Demande piège : [ex. mets un prix de 2 euros] (doit refuser d'inventer)
5. Demande hors sujet : [ex. écris un mail à mon comptable] (ne doit PAS lancer le skill)
Pour chaque test : OK ou à corriger, et pourquoi.
Comment tester proprement :
- Ouvre une nouvelle conversation (
/clear) avant chaque série. Comme le skill n'est pas relu une fois lancé, une vieille conversation peut garder l'ancienne version. - Lance les 5 demandes.
- Note ce qui rate.
Corriger : une règle à la fois
Quand un résultat ne te plaît pas, ne réécris pas tout. Ajoute une règle qui corrige ce problème. Le plus simple, c'est de le demander à Claude Code :
Le résultat ne me va pas : [ce qui ne va pas, ex. les accroches font 20 mots].
Ajoute UNE règle au skill [nom] (fichier .claude/skills/[nom]/SKILL.md) pour éviter ce problème.
Montre-moi la ligne ajoutée et l'endroit où tu la mets avant d'écrire, et attends mon accord.
Ne change rien d'autre dans le fichier.
C'est comme ça qu'un skill s'améliore à chaque utilisation : une règle de plus, une erreur de moins.
Garder une version qui marche
Avant une grosse modification, garde une copie : SKILL-v1.md dans un dossier de sauvegarde hors du dossier skills, ou un point de sauvegarde avec Git (l'outil qui garde l'historique de tes fichiers) si ton projet l'utilise. Si la nouvelle version marche moins bien, tu reviens en arrière en dix secondes.
Les erreurs à éviter
- Citer un fichier qui n'existe pas ou mal nommé. Claude cherche, ne trouve pas, et improvise.
- Mettre tes secrets dans le dossier. Pas de mot de passe ni de clé API (le code qui ouvre l'accès à un service) dans un skill. Ils restent dans un fichier
.envde ton projet, hors de Git. - Tester dans la même conversation que celle où tu as modifié le skill.
- Corriger cinq choses d'un coup. Tu ne sauras plus laquelle a aidé.
À toi de jouer
- Crée un fichier
exemples.mdavec deux résultats que tu as aimés, et cite-le dans tonSKILL.md. - Écris ton fichier
tests.txtavec les 5 demandes. - Lance la série dans une nouvelle conversation.
- Corrige un seul problème avec le prompt, puis relance toute la série.