Claude Skills de 0 à 100 : ce que c'est et comment créer la tienne

Tu expliques à Claude ta façon de rédiger un rapport. Ça marche à merveille. Demain tu ouvres un autre chat et tu dois lui réexpliquer. Et le lendemain, pareil. Cette boucle, c'est exactement ce que les skills viennent casser : tu emballes un processus une seule fois et Claude l'utilise au bon moment, sans que tu aies à le réexpliquer.

Ce guide va de zéro à ta première skill fonctionnelle : ce que c'est, comment Claude décide de l'utiliser, comment créer la tienne étape par étape et les erreurs qui la laissent morte avant même de commencer.

Ce qu'est une skill (et ce qu'elle n'est pas)

Une skill est un dossier contenant un fichier appelé SKILL.md. Ce fichier renferme des instructions en langage naturel pour une tâche précise : comment tu écris tes e-mails, comment tu montes un rapport, quelles règles tu suis pour relire du code. En option, elle peut embarquer d'autres éléments —modèles, documents de référence, scripts— mais le cœur reste toujours le SKILL.md.

La différence avec ce que tu connais déjà :

• Un prompt, c'est toi qui le colles à chaque fois. Du travail manuel, répété.
• Un CLAUDE.md est un contexte fixe de projet : il est lu au démarrage de la session dans ce dossier.
• Une skill est modulaire et par thème. Claude en a plusieurs et choisit celle qui s'applique selon ta demande. Elle sert dans n'importe quel projet, pas dans un seul.

Si tu as un processus que tu répètes à des endroits différents, c'est une skill.

Comment Claude lit les skills : les trois niveaux

Voici la clé technique qui explique tout le reste. Claude ne charge pas tes skills en entier d'un coup —ça gaspillerait du contexte pour rien—. Il les lit sur trois niveaux, ce qu'on appelle le progressive disclosure :

1. Frontmatter (toujours chargé). Uniquement le name et la description de chaque skill. C'est "l'étiquette" que Claude a toujours sous les yeux pour savoir ce qui est disponible.
2. SKILL.md complet (chargé si ça s'applique). Quand ta demande colle avec la description, Claude ouvre le corps du fichier et lit les instructions.
3. Fichiers en plus (à la demande). Des dossiers comme references/, scripts/ ou assets/ ne sont touchés que si la tâche en a besoin.

La conséquence pratique est énorme : tout le poids de l'activation de ta skill repose sur la description, car c'est la seule chose que Claude voit avant de décider. Si la description ne lui dit pas clairement quand l'utiliser, il ne se donne même pas la peine d'ouvrir le reste.

Le frontmatter : name et description

Le frontmatter, ce sont les deux lignes placées au début du SKILL.md, entre ---. Minimales mais décisives.

name — l'identifiant, en kebab-case (minuscules et tirets). Des règles qu'on ne contourne pas :

• Minuscules, mots séparés par des tirets : relecteur-d-emails, pas Relecteur_Emails.
• Sans le mot "claude" ni "anthropic" dedans.
• Sans balises ni caractères bizarres.

description — la phrase qui décide de ta vie. Elle doit dire deux choses : QUOI fait la skill et QUAND l'utiliser, avec des phrases qui ressemblent à ta façon de demander les choses. Tu disposes d'environ 1024 caractères ; ne les gaspille pas en marketing, dépense-les en déclencheurs concrets.

# ❌ MOLLE — Claude ne sait pas quand l'activer
---
name: emails
description: Aide avec les courriers électroniques.
---

# ✅ BONNE — dit QUOI + QUAND avec de vrais déclencheurs
---
name: relecteur-d-emails-blackdark
description: >
Relit et réécrit des e-mails avec la voix de Blackdark : direct, sans
remplissage, objet clair et un seul appel à l'action. Utilise-la quand
l'utilisateur demande "relis cet e-mail", "améliore ce courrier",
"réécris ce message pour qu'il sonne mieux" ou colle un brouillon d'e-mail
à envoyer.
---

Regarde bien la version bonne : elle inclut les phrases littérales avec lesquelles tu demanderais la tâche ("relis cet e-mail", "améliore ce courrier"). C'est ça qui accroche. Une description vague est la cause numéro un d'une skill qui ne se déclenche jamais.

Crée ta première skill, étape par étape

On va monter une skill pour de vrai. Deux chemins.

Chemin A — la faire générer par Claude. Tu lui décris le cas en langage naturel ("je veux une skill qui relit mes e-mails avec un ton direct, un objet clair et un seul CTA") et il t'écrit le SKILL.md. Rapide pour démarrer ; ensuite tu affines la description à la main.

Chemin B — à la main. Plus de contrôle et tu comprends mieux ce qui se passe. Structure recommandée du corps :

---
name: relecteur-d-emails-blackdark
description: >
Relit et réécrit des e-mails avec la voix de Blackdark : direct, sans
remplissage, objet clair et un seul appel à l'action. Utilise-la quand
l'utilisateur demande "relis cet e-mail", "améliore ce courrier" ou colle
un brouillon à envoyer.
---

# Relecteur d'e-mails Blackdark

## Instructions
- Ton direct et concret. Fini le remplissage, fini "j'espère que tu vas bien".
- Objet clair de moins de 50 caractères.
- Un seul appel à l'action, à la fin, sans ambiguïté.
- Respecte la langue du brouillon original.

## Étapes
1. Lis le brouillon et repère l'objectif réel de l'e-mail.
2. Réécris : objet + corps, maximum 120 mots sauf demande contraire.
3. Indique sur une ligne à part ce que tu as changé et pourquoi.

## Exemple
Entrée : "Salut, je voulais voir si on pourrait peut-être caler un appel
quand tu peux pour parler du projet, merci."
Sortie :
Objet : Appel de 20 min cette semaine
Corps : Un appel de 20 min jeudi à 11h00 pour boucler le projet, ça te va ?
Sinon, donne-moi deux créneaux et je m'adapte.

## Erreurs à éviter
- N'invente pas de données qui ne sont pas dans le brouillon.
- N'ajoute pas plus d'un CTA même si l'original mélange plusieurs intentions.

Maintenant, place-la là où Claude la lit :

• Dans Claude Code : crée le dossier ~/.claude/skills/relecteur-d-emails-blackdark/ et mets-y le SKILL.md. Redémarre la session et c'est tout.
• Dans claude.ai : compresse le dossier en un .zip et téléverse-le depuis le panneau des skills ; ensuite active-la avec son interrupteur.

Le nom du dossier et le name du frontmatter doivent coïncider, et le fichier doit s'appeler exactement SKILL.md, en majuscules.

Comment la tester (sur deux fronts)

Ne considère pas une skill comme bonne avant d'avoir testé les deux choses qui peuvent échouer séparément :

1. Est-ce qu'elle s'active seule ? Demande-lui la tâche avec tes vrais mots —sans recopier la description— et regarde si Claude l'utilise sans que tu le lui dises. Teste trois ou quatre variantes de ta façon réelle de demander. Si elle ne se déclenche pas, le problème est dans la description.
2. Est-ce que le résultat est correct ? Une fois activée, vérifie que la sortie respecte les règles (format, ton, limites). Si elle s'active mais ignore les instructions, c'est souvent que l'essentiel est enterré à la fin ou écrit de façon ambiguë.

Erreurs courantes (et comment les corriger)

Les ratés sont presque toujours les cinq mêmes :

• Elle ne s'active jamais → description vague, sans "quand". Réécris-la avec des phrases déclencheuses concrètes, celles que tu emploierais en demandant la tâche.
• Elle s'active trop, en se fourrant là où on ne l'appelle pas → description trop large. Cerne le domaine et dis explicitement quels cas elle NE couvre PAS.
• Il ne la reconnaît pas au téléversement → le fichier ne s'appelle pas exactement SKILL.md, ou le name n'est pas en kebab-case, ou il ne coïncide pas avec le dossier.
• Elle s'active mais ne suit pas les règles → le critique est enterré. Remonte les règles importantes tout en haut et donne-leur un format clair (listes, gras).
• Elle est lente ou consomme beaucoup → le SKILL.md est un pavé. Garde-y l'essentiel et déplace le détail long vers des fichiers dans references/ qui ne se chargent que quand c'est nécessaire.

Une skill bien faite est courte dans le SKILL.md, redoutable dans la description et honnête sur les cas où NE PAS l'utiliser. Commence par une seule, celle du processus que tu répètes le plus, et affine-la jusqu'à ce qu'elle se déclenche seule. Quand tu verras Claude faire ta tâche sans que tu la lui expliques, tu auras tout compris.