Les skills de Claude Code : créer vos propres commandes
Un skill est un dossier qui contient un fichier SKILL.md : des instructions que Claude Code ajoute à ses outils. Il le charge seul quand votre demande correspond à sa description, ou quand vous tapez son nom précédé d'une barre oblique. C'est la place des procédures qui reviennent, celles qui n'ont rien à faire dans CLAUDE.md.
Où placer un skill
| Dossier | Portée |
|---|---|
~/.claude/skills/<nom>/SKILL.md | Vous, dans tous vos projets |
.claude/skills/<nom>/SKILL.md | Le projet, partagé avec l'équipe par le dépôt |
<plugin>/skills/<nom>/SKILL.md | Les projets où le plugin est installé |
| Dossier des réglages gérés | Toute l'organisation |
Le nom du dossier devient la commande : un dossier compte-rendu donne /compte-rendu. Les anciennes commandes personnalisées (.claude/commands/) continuent de fonctionner : elles ont été fusionnées dans les skills, et si un skill et une commande portent le même nom, le skill l'emporte.
Un exemple complet
---
name: compte-rendu
description: Rédige le compte rendu d'une réunion à partir de notes brutes. À utiliser quand on colle des notes de réunion ou qu'on demande un compte rendu.
argument-hint: [fichier-de-notes]
---
# Compte rendu de réunion
1. Lire les notes : $ARGUMENTS
2. Extraire les décisions, les actions (qui, quoi, pour quand) et les questions ouvertes.
3. Rédiger le compte rendu selon modele.md, en français. Une information absente
des notes reste absente du compte rendu.
4. Enregistrer le fichier dans comptes-rendus/, la date du jour dans le nom.---. Le dossier contient aussi modele.md : SKILL.md le cite, Claude ne le lit que lorsqu'il en a besoin.Les réglages de l'en-tête
| Champ | Effet |
|---|---|
name | Le nom de la commande. Par défaut, celui du dossier. |
description | Ce que fait le skill et quand s'en servir. Claude s'y fie pour décider de le charger seul. |
disable-model-invocation: true | Claude ne le déclenche plus seul : il ne part que sur /nom. |
user-invocable: false | Le skill disparaît du menu /, Claude peut encore s'en servir. |
allowed-tools | Les outils utilisables sans vous demander, le temps du tour où le skill est appelé. |
context: fork | Le skill tourne dans un sous-agent séparé, avec son propre contexte. |
Pour les arguments : $ARGUMENTS reçoit tout ce qui suit la commande, $0, $1 et suivants reçoivent chaque mot dans l'ordre. Si le skill ne contient aucun de ces repères, Claude Code ajoute ce que vous avez tapé à la fin, précédé de ARGUMENTS:.
Le déclencher
- À la main :
/compte-rendu notes-lundi.md. - Automatiquement : vous écrivez « voici mes notes de réunion, il me faut un compte rendu », Claude reconnaît la description et charge le skill.
- Pour une action qui engage (publier, envoyer, mettre en ligne), ajoutez
disable-model-invocation: true: vous gardez la main sur le moment où elle part.
Les règles qui évitent les ennuis
- Gardez SKILL.md sous 500 lignes, conseille Anthropic. Le détail va dans des fichiers à côté, que SKILL.md cite pour que Claude sache quand les ouvrir.
- Une fois chargé, le contenu du skill reste dans la conversation pour la suite : chaque ligne inutile se paie à chaque échange.
- La description fait le déclenchement. Écrivez-y les mots que vous emploierez vraiment pour demander la tâche. Elle est tronquée à 1 536 caractères dans la liste des skills.
- Un skill venu d'un dépôt peut s'accorder des outils avec
allowed-tools. Relisez cette ligne avant de lancer Claude Code dans un dépôt qui n'est pas le vôtre. - Une erreur dans l'en-tête ne bloque rien : le skill se charge sans ses réglages, et un champ mal orthographié est ignoré sans message. Testez le skill après chaque modification de l'en-tête.
Skill, CLAUDE.md, sous-agent ou hook ?
| Besoin | Où l'écrire |
|---|---|
| Une règle valable à chaque session | CLAUDE.md |
| Une procédure en plusieurs étapes, utile de temps en temps | Un skill |
| Une tâche longue qui ne doit pas encombrer la conversation | Un skill avec context: fork, ou un sous-agent |
| Une étape qui doit avoir lieu à coup sûr | Un hook |
Chez nous
Au dernier relevé, 65 skills tournent sur nos projets. L'un rédige nos contrats à partir de clauses dont la source est vérifiée, un autre réécrit nos messages pour qu'ils sonnent comme une personne. Avant d'en créer un, on vérifie dans un index qu'aucun skill existant ne couvre déjà le besoin : si c'est le cas, on étend celui-là plutôt que d'en empiler un second.
Questions fréquentes
- Quelle différence entre un skill et une commande personnalisée ?
- Presque aucune aujourd'hui : les commandes de
.claude/commands/ont été fusionnées dans les skills et continuent de fonctionner. Le skill ajoute un dossier pour ses fichiers annexes et peut se déclencher sans que vous le tapiez. - Claude utilise-t-il un skill sans qu'on le lui demande ?
- Oui, quand votre demande correspond à sa description. Pour l'en empêcher, ajoutez
disable-model-invocation: truedans l'en-tête : le skill ne part plus que sur commande. - Comment partager un skill avec son équipe ?
- Placez-le dans
.claude/skills/du projet et versionnez-le : chaque personne qui ouvre le dépôt l'a. Pour le partager entre plusieurs projets, un plugin le distribue. - Un skill peut-il lancer un script ?
- Oui. Le dossier peut contenir des scripts : Claude les exécute sans charger leur code dans la conversation.
Sources consultées
- code.claude.com : skills · consulté le 04/11/2026
- code.claude.com : memory · consulté le 04/11/2026
ZAOURI est indépendante d'Anthropic, qui n'a ni approuvé ni sponsorisé ces guides. Claude et Claude Code sont des marques d'Anthropic.
Tous les guides Claude Code