Chapitre 2 · Écrire ton premier skill
La description, la ligne qui décide de tout
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLe pourquoi
Quand tu écris une demande, Claude Code regarde la liste de tes skills : un nom et une description pour chacun. C'est la description qui lui fait dire « ce skill correspond » ou « pas lui ».
Exemple : Marc, coach sportif, écrit description: Aide pour mes clients. Résultat : quand il demande « fais le compte rendu de la séance de Paul », Claude n'y pense pas. Et quand il demande un mail de bienvenue, le skill part au mauvais moment. Une description vague rate dans les deux sens.
La recette d'une bonne description
Une bonne description répond à deux questions, dans cet ordre :
- Ce que fait le skill, avec le résultat concret : « Écrit le compte rendu d'une séance de coaching à partir de mes notes : objectifs, exercices, ressenti, devoirs pour la semaine. »
- Quand l'utiliser, avec les mots que tu emploies vraiment : « À utiliser quand je demande un compte rendu, un résumé de séance, un bilan de séance, ou quand je colle mes notes de séance. »
Trois conseils en plus :
- Le cas principal en premier. La documentation indique que le texte de la description est coupé au-delà de 1 536 caractères dans la liste que lit Claude. Tu n'en as pas besoin d'autant, mais l'essentiel doit être au début.
- Tes synonymes. « Légende », « texte de post », « description Instagram » : liste les mots que tu tapes réellement.
- Une seule tâche. Si ta description contient « et aussi », c'est sans doute deux skills.
Avant / après
Vague :
description: Fait des trucs pour Instagram.
Précise :
description: Écrit la légende d'un post Instagram pour la boulangerie (3 versions courtes, ton chaleureux, hashtags locaux). À utiliser quand je demande une légende, un texte de post, une description Instagram, ou quand j'envoie une photo de produit à publier.
La seconde dit quoi, pour qui, sous quelle forme, et liste les phrases déclencheuses.
Le cas des skills qui envoient ou publient
Certains skills ne doivent jamais partir tout seuls : un skill qui prépare un envoi groupé, une publication, une suppression. Pour eux, la documentation prévoit une ligne dans l'en-tête :
---
name: envoi-newsletter
description: Prépare l'envoi de la newsletter mensuelle aux abonnés.
disable-model-invocation: true
---
Avec disable-model-invocation: true, le skill ne se lance que si tu tapes /envoi-newsletter. Claude ne le chargera pas de lui-même. Et dans les étapes, garde quand même une pause : « montre-moi le texte final et attends mon accord avant tout envoi ».
Le bloc à copier : le modèle de description
description: [Verbe d'action] [le résultat concret] pour [qui ou quoi] ([forme du résultat : nombre de versions, longueur, ton]). À utiliser quand je demande [mot 1], [mot 2], [mot 3], ou quand [situation typique, ex. je colle mes notes].
Et ce prompt pour la faire relire par Claude Code :
Voici la description de mon skill [nom] :
[colle ta description]
Joue le relecteur exigeant :
1. Est-ce qu'on comprend ce que fait le skill en une lecture ?
2. Propose 5 phrases que je pourrais taper et qui devraient le lancer.
3. Propose 3 phrases proches qui ne devraient PAS le lancer.
4. Propose une version améliorée, en gardant mes mots.
Ne modifie aucun fichier.
Tester le déclenchement
- Ouvre une nouvelle conversation (
/clear). - Tape une des phrases « qui devraient le lancer », sans le
/. - Regarde si Claude indique qu'il utilise ton skill.
- Fais pareil avec une phrase « qui ne devrait pas ».
Si le skill ne part pas, la documentation conseille : vérifier que la description contient les mots que tu emploies, reformuler ta demande pour s'en rapprocher, ou le lancer directement avec /nom.
Les erreurs à éviter
- Une description qui décrit le skill mais pas le moment. « Écrit des légendes » sans « à utiliser quand » : le déclenchement devient aléatoire.
- Des mots que tu n'emploies jamais. Si tu dis « post », n'écris pas seulement « publication ».
- Une description qui couvre trop. « Pour tout ce qui concerne mes clients » attrape tout et n'importe quoi.
- Oublier
disable-model-invocation: truesur un skill qui envoie ou publie.
À toi de jouer
- Réécris la description de ton skill avec le modèle.
- Fais-la relire avec le prompt.
- Teste 3 phrases qui doivent le lancer et 2 qui ne doivent pas. Note les résultats.
- Ajuste les mots jusqu'à ce que les 5 tests soient bons.