La réponse courte
Si l’appel d’un Skill par son nom fonctionne, il est installé. Le fait qu’il se lance tout seul dépend de sa description, que l’agent lit en premier et peut raccourcir. Testez les deux séparément, car ils échouent pour des raisons différentes.
Comment chaque agent choisit un Skill
Chaque agent lit d’abord une liste de noms et de descriptions de Skills, et ne charge les instructions complètes d’un Skill qu’après l’avoir choisi. Cette liste provient du front matter de chaque SKILL.md (le fichier que beaucoup cherchent sous le nom skills.md), et elle a un budget de taille :
| Agent | Lit en premier | Quand la place manque |
|---|---|---|
| Claude Code | Nom et description, plus when_to_use s’il est défini ; jusqu’à 1 536 caractères chacun | La liste dispose d’environ 1 % de la fenêtre de contexte ; les descriptions les moins utilisées disparaissent en premier |
| Codex | Nom, description et chemin du fichier | La liste dispose d’environ 2 % de la fenêtre de contexte ; les descriptions sont d’abord raccourcies |
| Cursor | Nom et description | Non documenté |
Avec beaucoup de Skills installés, une description longue ou vague peut être tronquée ou écartée avant même que l’agent l’examine. C’est pourquoi la première phrase compte le plus.
Rédiger une description de Skill qui sera retenue
Rédigez la description comme un collègue demanderait le travail, et placez l’usage principal dans la première phrase.
L’agent compare votre demande à ces mots : utilisez donc ceux que les gens tapent réellement, comme « landing page », « page de lancement » ou « pitch deck ». Nommez d’abord le résultat, puis dites quand l’utiliser.
Ce qu’il produit et quand
- « Build a product launch page with a hero, feature grid, and pricing toggle. Use when asked for a landing or launch page. »
Générique
- « Helps with websites. »
- Elle entre en concurrence avec tous les autres Skills web et ne dit presque plus rien une fois raccourcie.
Comment tester s’il se déclenche
Testez dans cet ordre. La première étape écarte un problème d’installation : tout ce qui échoue ensuite pointe donc vers la description.
- 1Appelez-le par son nom. Si cela échoue, c’est un problème d’installation ; consultez Dépannage.
- 2Démarrez une nouvelle session, pour que l’appel précédent ne soit pas dans le contexte, et formulez la demande en langage courant, sans le nom.
- 3Demandez à l’agent quel Skill il a utilisé, puis vérifiez une instruction que seul ce Skill suivrait.
Quand le mauvais Skill s’exécute
Cela signifie généralement que deux descriptions se chevauchent, ou que le même Skill est installé deux fois.
- Appelez celui que vous voulez par son nom. Un appel par le nom l’emporte toujours.
- Resserrez les descriptions qui se chevauchent par entrée, public ou résultat, pour que chaque Skill ait un rôle clair.
- Même nom à deux endroits : Claude Code privilégie Enterprise, puis personnel, puis projet. Codex peut afficher les deux. Ne gardez qu’une copie.
Questions fréquentes
Pourquoi mon Claude Skill ne se déclenche-t-il pas ?
Appelez-le d’abord par son nom. Si cela échoue, le Skill n’est pas installé là où l’agent cherche ; si seules les demandes en langage courant échouent, réécrivez la description avec les mots que vous tapez réellement.
Comment Claude décide-t-il quel Skill utiliser ?
Il lit le nom et la description de chaque Skill, puis charge celui qui correspond le mieux à votre demande. Taper /skill-name contourne cette correspondance et exécute le Skill nommé.
Que doit dire la description d’un Skill ?
Ce que produit le Skill et quand l’utiliser, avec l’usage principal dans la première phrase. Utilisez les mots que les gens tapent réellement, comme « landing page » ou « pitch deck », car la description peut être raccourcie.
Le fichier s’appelle-t-il SKILL.md ou skills.md ?
C’est SKILL.md, un dans chaque dossier de Skill. Son front matter contient le nom et la description que les agents lisent pour choisir un Skill.
Sources
Ce guide vous a-t-il aidé ?