Vérifier le déclenchement, corriger les erreurs et itérer
🎯 ObjectifTester avec plusieurs prompts · Diagnostiquer un problème · Corriger les 5 erreurs fréquentes · Améliorer sa description
Les 5 erreurs fréquentes
#
Erreur
Correction
1
Description trop vague
Ajouter des mots-clés déclencheurs et synonymes
2
Nom avec espaces ou majuscules
Uniquement minuscules + tirets
3
Instructions trop courtes
Ajouter structure, règles, exemples et interdits
4
Structure ZIP incorrecte
ZIP > dossier > SKILL.md (pas à la racine)
5
Code execution désactivé
Vérifier Settings > Capabilities en premier
La technique du « pushy »
AVANT (passif) :
description: Crée des comptes-rendus de réunion
APRÈS (pushy) :
description: Crée des CRs de réunion selon le modèle interne.
Utilise TOUJOURS ce Skill quand l'utilisateur mentionne
un compte-rendu, un CR, un résumé de séance, ou demande
de formaliser des notes de réunion, même sans mentionner
explicitement "CR".
📌 Règle d'orRépondez à 2 questions : Qu'est-ce que ce Skill fait ? Dans quels cas précis l'utiliser ?
Session 5 · Pas à pas
Diagnostiquer et corriger un Skill
Arbre de décision en 5 questions
💡 MéthodeSuivez cet arbre de diagnostic dans l'ordre. Arrêtez-vous à la première question dont la réponse est "non".
?
Le toggle du Skill est-il activé ?
▶
Non → Aller dans Personnaliser → Compétences et activer le toggle. C'est la cause la plus simple et la plus fréquemment oubliée. Oui → Passer à la question suivante.
?
Code execution est-il activé ?
▶
Non → → Paramètres → Fonctionnalités → activer Code execution and file creation. Les Skills nécessitent cet environnement. Oui → Passer à la question suivante.
?
La description est-elle précise avec des mots-clés ?
▶
Non → Modifier le SKILL.md : ajouter des mots-clés, des synonymes, des formulations alternatives. Re-uploader en ZIP. Oui → Passer à la question suivante.
?
Le déclenchement est-il irrégulier (parfois oui, parfois non) ?
▶
Oui → Appliquer la technique pushy : ajouter « Utilise TOUJOURS ce Skill quand... » avec une liste exhaustive de contextes déclencheurs. Non → Passer à la question suivante.
?
Le Skill se déclenche mais le résultat est décevant ?
▶
Oui → Enrichir les instructions : ajouter un exemple de bon résultat, des règles plus précises, une section « Ce que Claude NE DOIT PAS faire ». Non → Votre Skill fonctionne parfaitement !
Session 5 · Quiz
Valider vos acquis — 4 questions
Question 1 / 4
Votre Skill ne se déclenche jamais malgré des demandes pertinentes. Quelle est la PREMIÈRE chose à vérifier ?
Réécrire toutes les instructions du SKILL.md
Désinstaller et réinstaller Claude.ai
Vérifier que le toggle du Skill est activé ET que Code execution est ON
Toujours commencer par les vérifications les plus simples : toggle activé ? Code execution activé ? Ces deux points résolvent 80% des problèmes de déclenchement.
Question 2 / 4
La technique « pushy » consiste à...
Rendre les instructions plus longues et détaillées
Rendre la description plus directive en listant précisément les contextes où le Skill DOIT s'activer
Ajouter des scripts Python pour forcer le déclenchement
La technique pushy = reformuler la description pour qu'elle soit plus directive. Ex : « Utilise TOUJOURS ce Skill quand... » suivi d'une liste exhaustive de contextes, mots-clés et synonymes.
Question 3 / 4
Quel est le meilleur moyen de modifier un Skill déjà uploadé ?
Impossible — il faut recréer le Skill de zéro
Modifier le SKILL.md, recréer le ZIP, supprimer l'ancien Skill et uploader le nouveau
Envoyer les modifications à Anthropic par email
Modifiez votre SKILL.md (demandez à Claude de l'améliorer), recréez le ZIP avec la nouvelle version, supprimez l'ancien Skill dans Customize > Skills, et uploadez le nouveau.
Question 4 / 4
Pour valider un Skill, combien de formulations différentes devez-vous tester au minimum ?
1 — si ça marche une fois c'est bon
2 — une directe et une reformulée
5 — incluant des formulations sans les mots-clés exacts
Testez au minimum 5 variantes, dont certaines sans les mots-clés exacts de votre description. Si le Skill ne se déclenche pas sur des formulations évidentes, c'est que la description est trop restrictive.
Session 5 · Checklist
Suis-je prêt(e) pour le Session 6 ?
0 / 9 acquis
🔬 J'ai testé mon Skill
J'ai testé avec au moins 5 formulations différentes
J'ai vérifié le déclenchement direct ET indirect
J'ai vérifié qu'il ne se déclenche PAS sur des demandes non pertinentes
🛠️ J'ai corrigé si nécessaire
J'ai appliqué la technique pushy sur ma description si le déclenchement était irrégulier
J'ai enrichi les instructions si le résultat était décevant
Je sais comment modifier et re-uploader un Skill
🧠 Je connais les erreurs à éviter
Je connais les 5 erreurs fréquentes et leurs solutions
Je sais appliquer le diagnostic en 5 questions
J'ai fait le quiz et obtenu 3/4 ou plus
🎯 Session 6Partager et réutiliser : export ZIP, Skills Directory, déploiement en équipe, open standard.