Chapitre 1 · L'essentiel
L'anatomie d'un SKILL.md et où le ranger
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementUn skill tient dans un seul fichier texte. Il a deux parties : un en-tête court, puis tes consignes.
L'en-tête
Tout en haut du fichier, entre deux lignes de trois tirets ---, quelques informations au format YAML (une clé, deux-points, une valeur) :
---
name: devis
description: Prépare un devis à partir de mes tarifs. À utiliser quand je demande un devis, une estimation ou un chiffrage.
---
name: le nom du skill. S'il est absent, c'est le nom du dossier qui sert. Garde-le court, en minuscules, avec des tirets :devis,reponse-avis.description: recommandée par la documentation, et c'est la ligne la plus importante. Claude Code la lit pour savoir quand lancer le skill tout seul. Dis ce que fait le skill, puis « À utiliser quand... » avec les mots que tu emploies vraiment.
Une description vague (« aide pour les devis ») se déclenche mal. Une description précise, avec tes mots à toi (« devis, estimation, chiffrage »), se déclenche au bon moment.
Les consignes
Sous l'en-tête, tu écris ta méthode en français, comme tu l'expliquerais à un nouvel assistant :
- Le rôle : ce que le skill doit produire.
- Les étapes, numérotées, dans l'ordre.
- Le format du résultat : longueur, structure, nom du fichier.
- Les interdits : ce qui ne doit jamais arriver.
- Le point d'arrêt : à quel moment il te montre le résultat avant d'aller plus loin.
Où le ranger
Un skill, c'est un dossier à son nom, avec le SKILL.md dedans :
- Pour tous tes projets : dans ton dossier personnel,
~/.claude/skills/devis/SKILL.md. - Pour un seul projet : dans le dossier du projet,
.claude/skills/devis/SKILL.md.
Le signe ~ désigne ton dossier utilisateur (sur Windows, C:\Users\<ton nom>). Attention : copie le dossier entier, pas seulement le fichier.
Si tu as d'anciennes commandes rangées dans .claude/commands/, elles continuent de marcher : elles sont désormais fusionnées avec les skills.
Les deux façons de l'appeler
- À la main : tape
/suivi du nom, puis ta demande. Par exemple/devis cuisine M. Martin. - Automatiquement : quand ta demande correspond à la description, Claude Code charge le skill de lui-même. Avec un skill
reponse-avis, coller un avis et écrire « réponds à ce client » peut suffire.
Tu veux qu'un skill ne parte jamais tout seul, par exemple parce qu'il envoie quelque chose ? Ajoute cette ligne dans l'en-tête :
disable-model-invocation: true
Il ne se lancera alors que si tu tapes son nom.
Vérifier qu'il est reconnu
- Tape
/skills: la liste de tes skills s'affiche. - Un skill manque ? Si le dossier
skillsn'existait pas au lancement de la session, ferme Claude Code et rouvre-le dans ton dossier : il relit tes skills au démarrage. - Toujours rien ? Vérifie que le fichier s'appelle exactement
SKILL.md, en majuscules, dans un sous-dossier deskills.
À toi de jouer
Crée le dossier ~/.claude/skills/ s'il n'existe pas, puis un sous-dossier au nom d'une des tâches notées à la leçon précédente. Il est prêt à recevoir ton premier SKILL.md.