Aller au contenu
Floskool

Chapitre 1 · L'essentiel

L'anatomie d'un SKILL.md et où le ranger

Leçon gratuite 7 minGroupe Claude Code

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Un 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

  1. Tape /skills : la liste de tes skills s'affiche.
  2. Un skill manque ? Si le dossier skills n'existait pas au lancement de la session, ferme Claude Code et rouvre-le dans ton dossier : il relit tes skills au démarrage.
  3. Toujours rien ? Vérifie que le fichier s'appelle exactement SKILL.md, en majuscules, dans un sous-dossier de skills.

À 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.