La description qui fait lancer ton skill
Ton skill peut être parfait : si sa description est floue, Claude ne l'ouvre jamais. Tout se joue en deux lignes, tout en haut du fichier. Voici ma méthode pour les écrire.
Comment Claude choisit
1La formule
Une bonne description dit deux choses : ce que fait le skill, et quand l'utiliser. Avec les mots que tu emploies vraiment.
[Verbe d'action] [ce qu'il produit] à partir de [ce que tu lui donnes].
À utiliser quand je parle de [mot 1], de [mot 2] ou de [mot 3].
Dans le fichier, ça donne :
---
name: redaction-devis
description: Rédige un devis à partir de mes notes d'appel. À utiliser quand je parle de devis, de chiffrage ou de proposition.
---
2Avant, après
3Le test des 5 phrases
- Écris 5 demandes comme tu les formules vraiment, un mardi pressé : « fais-moi le chiffrage pour Dupont ».
- Lance-les une par une, dans une conversation neuve.
- Le skill ne s'ouvre pas ? Ajoute dans la description le mot que tu as employé.
- Il s'ouvre quand il ne devrait pas ? Rends la description plus précise.
Toujours rien ? Les vérifications officielles
- Demande à Claude « Quels skills sont disponibles ? » pour voir s'il le connaît.
- Appelle-le directement avec /nom-du-skill dans Claude Code.
- Vérifie l'en-tête : les trois tirets doivent être sur la toute première ligne. Si l'en-tête est mal formé, Claude ne peut pas lire la description.
Avant d'installer le skill de quelqu'un d'autre, vérifie qui l'a écrit et ce qu'il fait : repérer l'arnaque en dix secondes.
Sources vérifiées le 16/10/2026 : Claude Code : les skills · Aide Claude : créer une skill personnalisée
Et maintenant ?
Ce que je fais avec les entreprises : je chiffre ce que leurs tâches répétitives leur coûtent, et je les accompagne pour les réduire avec l'IA. Sans jargon, sans dépendance.
Le premier échange est gratuitAmdy · Longueur d'avance. Suis-moi sur Instagram (@ardj.87), je décrypte l'IA sans bullshit, une notion par jour.