Écrire une description qui déclenche au bon moment
Une skill mal décrite reste muette quand on en a besoin ou s'invite là où elle n'a rien à faire. Cette leçon vous apprend à nommer et décrire votre skill pour qu'elle réponde aux bonnes demandes, à vérifier son déclenchement en conditions réelles et à décider qui a le droit de la lancer.
Mis à jour le 28 septembre 2026.
En bref
Claude décide d'utiliser une skill presque uniquement à partir de sa description : elle doit annoncer clairement son rôle et les situations où elle s'applique, dans le vocabulaire réel de vos demandes. Une description vague la rend muette ou envahissante. Pour un PM, c'est la ligne qui fait qu'une skill sert vraiment au quotidien.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de rédiger le nom et la description d'une skill pour qu'elle se déclenche sur les bonnes demandes et pas sur les autres, et de choisir qui peut l'invoquer (Claude, vous, ou les deux).
Les questions auxquelles cette leçon répond
Pourquoi ma Claude Skill ne se déclenche-t-elle pas quand je m'y attends ?
Le plus souvent, la description est trop vague ou n'emploie pas les termes de votre demande. Claude ne lit que cette description pour choisir, donc ce qu'elle ne mentionne pas ne déclenche rien.
Comment rédiger la description d'une skill pour qu'elle soit bien utilisée ?
Dites ce que la skill produit et quand l'utiliser, avec des déclencheurs concrets et le vocabulaire de vos demandes réelles. Précisez aussi les cas voisins où elle ne doit pas servir.
Peut-on empêcher Claude de lancer une skill tout seul ?
Oui. Dans Claude Code, un réglage du frontmatter réserve la skill à un lancement manuel, utile pour les actions sensibles ou coûteuses que vous voulez décider vous-même.
Thèmes abordés
- description de skill
- déclenchement d'une skill
- Claude Skills
- invocation
- SKILL.md
Dans le glossaire
Guides sur ce thème
- Claude Skills : créer et tester une skill
Anatomie d’un SKILL.md, installation, déclenchement, tests et sécurité, avec un modèle.
- Claude Skills ou MCP : lequel choisir
Ce qui distingue une skill d’un serveur MCP, quand utiliser l’un, l’autre ou les deux, avec une grille de décision.
Dans quel module
Concevoir et écrire sa skill
Comment écrire une skill qui se déclenche au bon moment, produit un résultat vérifiable et n'a que les permissions nécessaires ?
Leçons du module
- Écrire une description qui déclenche au bon moment (cette leçon)
- Cadrer sa skill avant de l'écrire
- Écrire le SKILL.md et l'installer
- Outils et permissions d'une skill
Ce que vous apprendrez dans ce module
Cette leçon fait partie de la formation Créer des Claude Skills fiables pour votre travail produit
- Rédiger un nom et une description qui déclenchent la skill au bon moment, et choisir qui peut l'invoquer.
- Concevoir un SKILL.md complet (frontmatter, règles vérifiables, procédure, format de sortie, fichiers de référence) à partir d'un cadrage.
- Configurer les outils pré-autorisés et retirés d'une skill selon le niveau de risque, sans confondre pré-autorisation et restriction.
Formations liées
- IA & DéveloppementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Travailler avec Claude Code sur un vrai projet : contexte, plan, revue
3 h
- IA & BusinessTout publicAucun pré-requis : accessible à toutes et tous.
Mettre l'IA au travail dans votre entreprise
2 h 10 min
- IA & DéveloppementJuniorQuelques bases utiles : notions de contexte ou du domaine.
Construire et mettre en ligne une app web avec un agent de code IA
2 h 45 min