Le mot « skill » fait peur parce qu'on l'associe à de la programmation. C'est l'inverse : un skill est du texte, en français si vous voulez, qui dit à Claude comment faire une chose précise. Si vous savez écrire une procédure pour un nouveau collaborateur, vous savez écrire un skill.
La règle que j'applique et que j'enseigne : tout ce qui se répète finit en procédure écrite que Claude relit à la demande, plutôt qu'en consigne qu'on retape. Cette page explique comment ça marche, avec un exemple à copier, et les erreurs qui font qu'un skill ne se déclenche jamais.
Un skill, c'est quoi concrètement ?
Un dossier, avec dedans un fichier SKILL.md. Ce fichier a deux parties :
- un en-tête, entre deux lignes
---, avec surtout une description (le seul champ que la documentation recommande) : la phrase qui dit à Claude quand utiliser le skill ; - des instructions en texte libre : ce que Claude doit faire, dans l'ordre.
Le nom du dossier devient la commande. Un dossier avant-publication donne la commande /avant-publication.
La force du système tient en une phrase de la documentation d'Anthropic : le corps d'un skill n'est chargé que lorsqu'il sert. En temps normal, Claude n'a sous les yeux que les descriptions de vos skills. Vous pouvez donc en avoir beaucoup, avec des procédures longues, sans encombrer chaque conversation.
Skill, CLAUDE.md, MCP, agent : qui fait quoi ?
Ces quatre mots reviennent ensemble et se confondent facilement.
| Outil | Ce que c'est | Quand c'est chargé | Exemple |
|---|---|---|---|
| CLAUDE.md | Les règles permanentes du projet | À chaque session, en entier | « Aucune clé secrète écrite dans le code » |
| Skill | Une procédure ou un savoir à utiliser au bon moment | La description toujours, le reste à la demande | « Comment on vérifie une page avant de la publier » |
| MCP | Une prise vers un outil extérieur | Les noms des outils au démarrage | Lire votre agenda, interroger votre outil de paiement |
| Sous-agent | Un assistant qui travaille dans son propre espace et rend un résumé | Quand Claude lui confie une tâche | Passer en revue tout le site et ne remonter que les erreurs |
Mon repère : si Claude doit le savoir tout le temps, c'est CLAUDE.md ; si c'est une façon de faire qui sert de temps en temps, c'est un skill. Les deux autres ont leurs pages : MCP et agents.
Les skills déjà fournis avec Claude Code
Avant d'écrire les vôtres, sachez que Claude Code en contient déjà. Tapez / pour voir la liste ; dans l'application de bureau, le bouton + puis Slash commands fait la même chose. Quelques-uns utiles même quand on ne code pas :
/doctorfait un bilan de votre installation et propose des corrections, en demandant votre accord avant de changer quoi que ce soit ;/code-reviewrelit les modifications en cours pour y chercher des erreurs ;/runet/verifylancent votre application pour vérifier qu'un changement fonctionne vraiment, pas seulement sur le papier ;/looprelance une consigne à intervalle régulier tant que la session reste ouverte, par exemple pour surveiller une mise en ligne.
Si vous êtes connecté au terminal avec un compte claude.ai, certains skills d'Anthropic, comme pdf (pour les PDF) et xlsx (pour les tableurs), sont aussi disponibles.
Créer votre premier skill sans écrire de code
La méthode simple : le faire écrire par Claude
Vous n'avez pas besoin de créer les dossiers vous-même. Dans Claude Code, décrivez le skill que vous voulez :
Crée un skill personnel nommé avant-publication, dans le dossier des skills
personnels, pour qu'il serve dans tous mes projets. Il doit se déclencher
quand je demande de publier ou de mettre en ligne. Il vérifie chaque page
modifiée sur téléphone et sur ordinateur, vérifie qu'aucune clé secrète
n'apparaît dans le code, teste les formulaires, puis me donne la liste de
ce qui va et de ce qui ne va pas AVANT de publier. Montre-moi le fichier.
Claude crée le dossier et le fichier, puis vous montre le résultat. Relisez-le comme vous reliriez une consigne écrite par un collègue : c'est votre procédure, elle doit dire exactement ce que vous voulez.
Ce que contient le fichier
Voici à quoi ressemble un SKILL.md simple :
---
description: Vérifie le site avant chaque mise en ligne. À utiliser quand je demande de publier, de mettre en ligne ou de vérifier une page.
---
Avant toute mise en ligne :
1. Ouvre chaque page modifiée en format téléphone et en format ordinateur.
2. Vérifie qu'aucune clé secrète n'apparaît dans le code.
3. Teste chaque formulaire modifié.
4. Donne-moi la liste de ce qui va et de ce qui ne va pas.
5. Ne publie qu'après mon accord.
Deux lignes comptent plus que les autres :
- la description, qui doit contenir les mots que vous utilisez vraiment (« publier », « mettre en ligne ») : c'est en la comparant à votre demande que Claude décide d'utiliser le skill ;
- les instructions importantes en premier : si la conversation devient très longue et que Claude la résume pour faire de la place, il ne garde que le début de chaque skill déjà utilisé (les 5 000 premiers « tokens », ces morceaux de mots que compte le modèle, selon la documentation).
Le tester
Deux façons : demander quelque chose qui correspond à la description (« on peut mettre en ligne ? »), ou taper /avant-publication. Si Claude ne le trouve pas, demandez-lui « What skills are available? » ou tapez /skills pour voir la liste.
Où ranger un skill
| Emplacement | Chemin | Où il sert |
|---|---|---|
| Personnel | .claude/skills/<nom>/SKILL.md dans votre dossier utilisateur | Tous vos projets sur cet ordinateur |
| Projet | .claude/skills/<nom>/SKILL.md à la racine du projet | Ce projet seulement ; à partager avec le projet si vous travaillez à plusieurs |
| Plugin | dans le dossier skills/ d'un plugin installé | Partout où le plugin est activé, sous le nom /plugin:skill |
| Compte claude.ai | réglages des skills sur claude.ai, ou Customize dans l'application de bureau | L'application de bureau, les sessions Cowork, les sessions dans le cloud, et les sessions du terminal où vous êtes connecté avec ce compte |
Un point qui piège : les sessions qui tournent dans le cloud ne lisent pas le dossier de skills de votre ordinateur. Si vous voulez qu'un skill y serve, activez-le sur votre compte claude.ai ou rangez-le dans le projet.
Claude Code surveille les dossiers de skills : un skill que vous ajoutez ou modifiez est pris en compte dans la session en cours, sans redémarrer. Seule exception : si le dossier de skills n'existait pas au démarrage de la session, tapez /reload-skills après l'avoir créé.
Décider qui déclenche le skill
Par défaut, vous pouvez appeler un skill et Claude aussi. Deux lignes d'en-tête changent cela :
disable-model-invocation: true: Claude ne peut pas le lancer seul, vous seul le pouvez. Indispensable pour tout ce qui a des conséquences : publier, envoyer un message, supprimer. La documentation d'Anthropic le dit avec son exemple : vous ne voulez pas que Claude décide de publier parce que le code « a l'air prêt ».user-invocable: false: seul Claude l'utilise. Pour un savoir de fond (« comment fonctionne notre ancien système de commandes ») qui n'a pas de sens comme commande.
Mon conseil : tout skill qui publie, envoie ou supprime lui-même quelque chose porte disable-model-invocation: true. C'est vous qui appuyez sur le bouton. Le skill avant-publication de l'exemple peut rester automatique : il ne fait que vérifier, et il attend votre accord avant toute mise en ligne.
Les erreurs qui font qu'un skill ne marche pas
Une description vague. « Aide pour le site » ne se déclenchera jamais au bon moment. Écrivez quand l'utiliser, avec vos mots : « À utiliser quand je demande de publier, de mettre en ligne ou de vérifier une page. »
Un skill qui se déclenche trop souvent. Rendez la description plus précise, ou ajoutez disable-model-invocation: true pour ne le lancer qu'à la main.
Un fichier trop long. Anthropic conseille de garder SKILL.md sous 500 lignes et de déplacer le détail dans des fichiers annexes du même dossier, que Claude ne lit qu'en cas de besoin. Une fois chargé, le contenu du skill reste dans la conversation pour tous les échanges suivants.
Trop de skills. Les descriptions de tous vos skills sont chargées en permanence, dans une enveloppe limitée (1 % de la mémoire de travail du modèle). Au-delà, Claude Code retire les descriptions des skills que vous utilisez le moins (seul leur nom reste), et ils risquent de ne plus se déclencher au bon moment. La commande /doctor estime la place que prend cette liste, et /skill-doctor montre ce que coûte chaque skill et repère ceux qui ne servent pas.
Une règle absolue confiée à un skill. Un skill est une consigne : Claude l'applique avec jugement, et peut la perdre de vue dans une très longue session. Pour une règle qui doit tenir à chaque fois sans exception, la documentation recommande un « hook », une vérification automatique que Claude Code lance à chaque action concernée.
Modifier un skill synchronisé. Les skills qui viennent de votre compte claude.ai sont téléchargés, jamais renvoyés : une modification faite sur votre ordinateur n'est pas enregistrée sur votre compte et peut être écrasée. Modifiez-les sur claude.ai.
Installer un skill trouvé en ligne sans le lire. Un skill peut contenir des commandes que Claude Code exécute au moment où il le charge, et pré-autoriser certains outils. Lisez-le, ou demandez à Claude de vous expliquer ce qu'il fait, avant de l'ajouter.
Aller plus loin : tester et partager ses skills
Un skill qui se déclenche n'est pas forcément un skill qui fait bien son travail. Anthropic propose un plugin officiel, skill-creator, qui compare les résultats avec et sans le skill sur des demandes réalistes, mesure à quel point il se déclenche au bon moment et propose des corrections de description. Pour l'installer dans le terminal : /plugin install skill-creator@claude-plugins-official ; dans l'application de bureau, par le bouton + puis Add plugins.
Pour partager un skill, rangez-le dans le projet (tous ceux qui travaillent dessus l'auront) ou dans un plugin. Les skills de Claude Code suivent la norme ouverte Agent Skills, utilisée par plusieurs outils d'IA : une bonne partie de ce que vous écrivez reste réutilisable ailleurs.
Si vous démarrez tout juste, commencez par le guide Claude Code pour débutants : les skills viennent après les premières sessions, quand on sait ce qu'on répète. Et si vous voulez qu'on écrive ensemble vos premières procédures sur votre projet, c'est exactement le genre de chose qu'on règle en trente minutes en visio de déblocage.
