Créer ton premier skill : tes instructions réutilisables

1. À la fin de cette leçon, tu sauras

Expliquer ce qu’est un skill et en quoi il diffère de CLAUDE.md.
Lire un fichier SKILL.md et repérer son nom, sa description et ses instructions.
Créer avec l’agent un petit skill personnel à partir d’une habitude de travail.
Tester que l’agent l’utilise au bon moment.

2. Pourquoi ça t’intéresse

Karim relit souvent des textes avec l’agent : comptes rendus de réunion, courriers, articles pour le bulletin de son club. À chaque fois, il retape la même consigne : « Garde mon style, ne réécris pas tout, signale les répétitions, vérifie les dates, liste les corrections à part. » Un jour il l’oublie, et l’agent lui réécrit tout le texte dans un style qui n’est pas le sien. Avec un skill « relecture à ma façon », la consigne est écrite une fois pour toutes, et l’agent l’applique dès qu’il s’agit de relire.

3. Avant de commencer


Il te faut	Claude Code, ton dossier de travail, une tâche que tu répètes souvent
Coût	Ton abonnement à l’agent (vérifie le prix du jour sur claude.com/pricing)
Durée	45 min

4. Comprendre en 3 minutes

Un skill, c’est une fiche de procédure que l’agent sort du tiroir quand il en a besoin.

Concrètement, c’est un dossier qui contient au minimum un fichier SKILL.md. Ce fichier commence par un petit en-tête avec deux informations essentielles :

Élément	Rôle
Nom	Identifie le skill (en minuscules, avec des tirets)
Description	Dit ce que fait le skill et quand l’utiliser
Instructions (le reste du fichier)	La procédure elle-même, en langage courant

Image mentale : une bibliothèque de recettes. L’agent ne lit pas tous les livres à chaque repas : il lit les titres et les résumés au dos, puis ouvre la recette qui correspond à ce qu’on lui demande. C’est pour ça que la description est si importante : c’est elle qu’il lit pour décider.

Différence avec CLAUDE.md :

CLAUDE.md : le contexte permanent de ton dossier, lu à chaque séance.
Un skill : une procédure précise, chargée seulement quand elle sert. Tu peux en avoir plusieurs sans alourdir chaque conversation.

Un skill peut être personnel (disponible dans tous tes dossiers) ou propre à un projet. L’emplacement exact des dossiers de skills est décrit dans la documentation officielle (code.claude.com/docs) : vérifie-le là-bas plutôt que de le deviner.

Un skill reste du texte que l’agent suit. Il n’est pas infaillible : on le teste et on l’ajuste, comme une demande.

5. Faire ensemble

Étape 1 · Écrire ta procédure en clair

Avant de parler à l’agent, note en quelques lignes comment tu veux qu’on relise tes textes. Par exemple :

Garder mon style et mon vocabulaire.
Corriger l’orthographe et la grammaire sans demander.
Signaler, sans les corriger, les répétitions et les phrases trop longues.
Vérifier la cohérence des dates et des noms propres.
Présenter les changements dans une liste à part.

Étape 2 · Discuter du skill avec l’agent

Lance claude dans ton dossier de travail :

Je veux créer un skill personnel appelé « relecture-a-ma-facon ».
Voici ma procédure : [colle tes lignes]. Avant de créer quoi que
ce soit, propose-moi le contenu du fichier SKILL.md, avec un nom,
une description qui dise clairement quand l'utiliser, et les
instructions. Dis-moi aussi où tu comptes le placer et pourquoi.

Étape 3 · Relire et ajuster la description

Vérifie surtout la description. Elle doit contenir les mots que tu emploies naturellement : « relis », « corrige », « relecture ». Si besoin :

Ajoute dans la description qu'il faut l'utiliser aussi quand je
demande de « vérifier un texte » ou de « corriger un courrier ».

Compare l’emplacement proposé avec la documentation officielle avant d’accepter.

Étape 4 · Créer et tester

Accepte la création du fichier. Puis, dans une nouvelle session (quitte et relance claude), teste avec une demande qui ne nomme pas le skill :

Relis ce paragraphe : [colle un texte à toi, avec quelques fautes].

Observe : l’agent garde-t-il ton style ? Liste-t-il les changements à part ? S’il ne semble pas utiliser le skill, demande-lui : « As-tu utilisé un skill pour cette réponse ? » puis améliore la description.

6. Faire toi-même

Choisis une tâche que tu répètes au moins une fois par semaine dans ta vie réelle : préparer l’ordre du jour d’une réunion, résumer un document administratif, rédiger une réponse à un client, trier des notes.

Consigne : crée avec l’agent un skill personnel pour cette tâche, avec une description qui précise quand l’utiliser, puis teste-le deux fois dans une nouvelle session, avec deux demandes formulées différemment.

Résultat attendu : un fichier SKILL.md que tu as relu, et deux tests où l’agent applique ta procédure sans que tu la rappelles.

7. Vérifier

Le dossier du skill contient un fichier SKILL.md.
L’en-tête contient un nom et une description qui dit quoi et quand.
Les instructions sont écrites en langage clair, compréhensible par toi.
L’emplacement correspond à ce que dit la documentation officielle.
Dans une nouvelle session, une demande qui ne nomme pas le skill le déclenche.
Tu as ajusté au moins une fois la description ou les instructions après un test.

8. Ce que tu gardes

Dans ton carnet de bord, note le nom de ton skill, son emplacement et la demande de test. Commence une liste « Skills à créer » : chaque fois que tu retapes la même consigne pour la troisième fois, c’est un candidat.

9. Pour aller plus loin

Transforme la relecture critique du module 7 (leçon 4) en skill.
Un skill peut aussi contenir des modèles ou des exemples dans son dossier : la documentation sur code.claude.com/docs explique comment.