Aller au contenu
Floskool

Chapitre 3 · Comprendre les skills

Un skill, c'est quoi et comment ça marche

Leçon gratuite 9 minGroupe Claude Code & IA

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

Suivre gratuitement

Un skill, c'est un dossier

Le pourquoi : arrêter de réexpliquer la même chose

Chaque fois que Léa demande un compte rendu, elle recolle les mêmes consignes : « Titre avec le nom du client, puis les décisions, puis les prochaines étapes, ton professionnel, une page maximum. » C'est fastidieux, et si elle oublie une consigne, le résultat change.

Un skill règle ce problème. La documentation d'Anthropic le définit comme un dossier d'instructions, de scripts et de ressources que Claude charge à la demande pour mieux réaliser une tâche précise. Tu écris la méthode une fois, et Claude l'applique chaque fois que c'est pertinent. La documentation le dit simplement : crée un skill quand tu recolles sans cesse les mêmes instructions ou la même procédure.

Le comment : l'anatomie d'un skill

Un dossier et un fichier SKILL.md

Un skill, c'est un dossier qui contient au minimum un fichier SKILL.md (un fichier texte au format Markdown). Ce fichier a deux parties :

  1. Le frontmatter (l'en-tête) : quelques lignes de réglages entre deux lignes ---. La première --- doit être la toute première ligne du fichier.
  2. Le corps : les instructions que Claude suivra quand le skill est actif.

Voici le modèle minimal donné par le dépôt officiel d'Anthropic :

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

Les deux champs à connaître

  • name : le nom affiché dans le menu /. S'il est absent, Claude Code prend le nom du dossier.
  • description : ce que fait le skill et quand l'utiliser. Dans Claude Code, tous les champs sont facultatifs, mais c'est celui que la documentation recommande. C'est lui qui permet le déclenchement automatique.

D'autres champs existent (par exemple disable-model-invocation, qu'on verra en leçon 9). Attention : un nom de champ mal orthographié est ignoré sans message d'erreur.

Des fichiers annexes, si besoin

Un skill peut contenir d'autres fichiers : des références, des exemples, des scripts (de petits programmes). Structure type donnée par la documentation :

my-skill/
├── SKILL.md        (obligatoire : vue d'ensemble et navigation)
├── reference.md    (chargé si besoin)
├── examples.md     (chargé si besoin)
└── scripts/
    └── helper.py   (exécuté, pas chargé)

La documentation conseille de garder SKILL.md sous 500 lignes et d'y indiquer quand lire chaque fichier annexe.

Comment un skill se déclenche

C'est le cœur du fonctionnement.

  1. En permanence, Claude ne garde en tête que la description de chaque skill installé. Le corps n'est pas chargé.
  2. Quand ta demande correspond à une description, Claude charge le skill complet et suit ses instructions. C'est le déclenchement automatique.
  3. Tu peux aussi l'appeler toi-même en tapant /nom-du-skill en début de message.

Côté plateforme, la documentation décrit ce chargement progressif : les métadonnées sont toujours chargées (environ 100 tokens par skill ; un token est un petit morceau de texte), les instructions au déclenchement (moins de 5 000 tokens), et les ressources et scripts seulement si besoin. Le code d'un script n'entre pas dans le contexte, seule sa sortie.

Conséquence pratique : la description fait tout. Si elle est floue, le skill ne se déclenche pas au bon moment. La documentation recommande de mettre le cas d'usage principal en premier, avec les mots que tu dirais naturellement.

Bloc à copier : demande à Claude Code de t'expliquer un skill

Une fois des skills installés (leçon 8), ce prompt t'aide à comprendre ce que tu as sans rien modifier.

Liste les skills disponibles. Pour chacun, explique-moi en une phrase
simple ce qu'il fait et quel genre de demande le déclenche.
Ne modifie aucun fichier.

Où vivent les skills

Selon la documentation, un skill peut être :

  • personnel, pour tous tes projets : ~/.claude/skills/<nom-du-skill>/SKILL.md (le ~ désigne ton dossier personnel) ;
  • de projet, pour un dossier précis : .claude/skills/<nom-du-skill>/SKILL.md ;
  • dans un plugin (un paquet qui regroupe des skills et d'autres éléments), appelé alors sous la forme /plugin:skill.

Si deux skills portent le même nom, la version d'entreprise passe avant la personnelle, qui passe avant celle du projet. Les skills de plugin sont préfixés, donc sans collision.

Si ça coince

  • « Je ne vois pas la différence avec un prompt » : un prompt, tu le recolles à chaque fois. Un skill, Claude le retrouve seul quand c'est utile.
  • Ton skill ne s'affiche pas : vérifie que le fichier s'appelle bien SKILL.md et qu'il est dans un dossier au bon emplacement.
  • Il s'affiche mais ne se déclenche jamais seul : la description est sans doute trop vague, ou l'en-tête YAML (le format du frontmatter) est invalide. On creuse en leçon 9.

À toi de jouer

Sur papier, écris le frontmatter d'un skill pour une de tes tâches répétitives : un name en minuscules avec tirets, et une description qui commence par le cas d'usage principal, avec tes mots. Léa a écrit : « name: compte-rendu-client ; description: Rédiger un compte rendu de rendez-vous client à partir de mes notes, quand je dis compte rendu ou CR. » Tu le transformeras en vrai skill au chapitre 4, avec skill-creator.

En bref

  • Un skill est un dossier avec un fichier SKILL.md : un en-tête et des instructions.
  • La description dit ce que fait le skill et quand l'utiliser : c'est elle qui le déclenche.
  • Claude garde seulement les descriptions en tête et charge le reste à la demande.
  • Tu peux aussi appeler un skill toi-même avec /nom-du-skill.
  • Un skill peut être personnel, de projet ou fourni par un plugin.