Ta première skill

Cette leçon est encore en test : elle s'améliore avec les retours des apprenants. Si quelque chose n'est pas clair, c'est la leçon qu'il faut corriger, pas toi.

À la fin de cette leçon, tu sauras

transformer une demande que tu répètes en skill ;
écrire une description qui permet à Claude de savoir quand l’utiliser ;
appeler ta skill avec /nom, ou la laisser se déclencher seule ;
l’améliorer après l’avoir testée.

Pourquoi ça t’intéresse

Tu as dans ta note « Mes demandes » des consignes que tu recopies souvent. Une skill les range une fois pour toutes : tu tapes /compte-rendu, ou tu dis simplement « fais le compte rendu », et Claude applique ta méthode. C’est aussi exactement comme ça que fonctionne le compagnon de cette formation.

Avant de commencer


Il te faut	Claude Code, ton dossier mon-espace-ia en mode Manuel, et la leçon 1 de ce module
Durée	40 minutes
Coût	Inclus dans ton abonnement

Comprendre en 3 minutes

Une skill, c’est un dossier qui contient un fichier SKILL.md. Ce fichier a deux parties :

un en-tête, entre deux lignes ---, avec le nom et surtout la description : Claude la lit pour savoir quand utiliser la skill ;
les consignes, en Markdown, que Claude suit quand la skill est utilisée.

D’après la documentation (24/10/2026) :

	Emplacement	Pour qui
Skill de projet	`.claude/skills/<nom>/SKILL.md`, dans ton dossier de travail	Ce dossier seulement
Skill personnelle	`~/.claude/skills/<nom>/SKILL.md`, dans ton dossier personnel (sous Windows : `%USERPROFILE%\.claude\skills\<nom>\SKILL.md`)	Tous tes projets sur cet ordinateur

Claude l’utilise quand c’est utile, ou quand tu tapes /nom. Contrairement à CLAUDE.md, seuls le nom et la description d’une skill sont lus à chaque séance ; ses consignes ne sont chargées que quand elle sert : tu peux y mettre une méthode détaillée sans alourdir chaque séance.

Faire ensemble

1Étape 1 : Choisir la demande

Exemple : tu fais souvent des comptes rendus à partir de notes en vrac. Ta demande habituelle ressemble à ceci :

Transforme ces notes en compte rendu : un titre, la date, les décisions, puis les actions avec un responsable. 15 lignes maximum. Signale ce qui manque au lieu de l'inventer.

2Étape 2 : Faire créer la skill

Dans mon-espace-ia, en mode Manuel, écris :

Crée une skill de projet nommée compte-rendu, dans .claude/skills/compte-rendu/SKILL.md. Description : « Transforme des notes en vrac en compte rendu court (décisions, actions, responsables). À utiliser quand je donne des notes de réunion ou d'appel. » Consignes : un titre, la date, les décisions, puis les actions avec un responsable, 15 lignes maximum, et signaler ce qui manque au lieu de l'inventer. Montre-moi le fichier avant de le créer.

Lis le fichier proposé : l’en-tête, la description, les consignes. Claude Code te demande l’autorisation, car le dossier .claude est protégé : en mode Manuel, écrire dedans demande ton accord. Autorise si le contenu te convient, pour cette fois seulement : « Autoriser » dans l’appli, le simple « Yes » dans le terminal. N’accepte pas l’option qui autorise les écritures dans .claude pour toute la séance (dans le terminal : « Yes, and allow Claude to edit files in this project’s .claude folder for this session ») : Claude pourrait alors modifier tes skills et tes réglages sans redemander jusqu’à la fin de la séance.

3Étape 3 : L’appeler par son nom

Ouvre une Nouvelle session dans le même dossier (dans l’appli : le bouton Nouvelle session ; dans le terminal : /exit, puis relance claude, ou tape /reload-skills), puis tape :

/compte-rendu Réunion du 12. Marc veut décaler le lancement. On garde la date du 3. Julie s'occupe des visuels. Budget pas encore validé.

(Ces notes sont inventées.) Le compte rendu doit suivre ta méthode, et signaler que le budget n’est pas validé.

4Étape 4 : La laisser se déclencher seule

Dans la même session, écris simplement :

Voici mes notes d'appel de ce matin, fais-en quelque chose de propre : appel avec le traiteur, il confirme 40 couverts, devis à recevoir lundi, il faut lui envoyer le plan de table.

Claude devrait reconnaître la situation décrite dans la description, et appliquer la skill.

Faire toi-même

Ta skill à toi.

Choisis dans « Mes demandes » une demande que tu répètes.
Transforme-la en skill de projet, avec une description qui commence par le cas d’usage.
Teste-la une première fois avec /nom.
Teste-la une seconde fois en décrivant simplement ton besoin.
Si elle ne se déclenche pas seule, rends la description plus précise.

Vérifier

C’est réussi si :

le fichier .claude/skills/<nom>/SKILL.md existe, avec une description qui dit quand l’utiliser ;
l’appel par /nom applique ta méthode ;
au moins un test sans le nom l’a déclenchée, éventuellement après avoir précisé la description.

Erreurs fréquentes :

une description vague (« aide pour les documents ») : Claude ne sait pas quand l’utiliser ;
une skill qui fait tout : une skill, une tâche ;
mettre dans la skill des informations sensibles : comme CLAUDE.md, elle est envoyée à l’IA quand elle sert.

Conserver et reprendre

Quand une skill de projet te sert partout, demande à Claude Code de la recopier en skill personnelle (~/.claude/skills/), après ton accord.

Pour aller plus loin

facultatif

La documentation officielle des skills, en anglais : code.claude.com/docs/en/skills (options de l’en-tête, skills qui lancent des commandes, partage dans un plugin).

Mots nouveaux

4 mots expliqués

Mot	Ce que ça veut dire
SKILL.md	Le fichier d’une skill : un en-tête (nom, description) et des consignes
En-tête	Les lignes entre deux `---` en haut du fichier, qui décrivent la skill
Skill de projet	Une skill rangée dans le dossier de travail, utilisable seulement là
Skill personnelle	Une skill rangée dans ton dossier personnel, utilisable dans tous tes projets

Points restant à vérifier : l’appel des skills de projet depuis l’appli de bureau, en capture réelle.