1. Accueil
  2. Créer avec l'IA
  3. Les skills de Claude Code

Les skills de Claude Code : vos procédures, écrites une fois pour toutes

Un skill est une fiche de procédure que Claude Code lit seulement quand il en a besoin : un dossier qui contient un fichier SKILL.md avec une courte description et des instructions. Claude le déclenche tout seul quand votre demande correspond à la description, ou vous l'appelez en tapant /nom-du-skill. On en crée un le jour où l'on se surprend à recopier les mêmes consignes, et on peut le faire écrire par Claude lui-même, en français, sans toucher au code.

Mis à jour le · Frédéric Lemonnier

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 :

  1. 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 ;
  2. 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.

OutilCe que c'estQuand c'est chargéExemple
CLAUDE.mdLes règles permanentes du projetÀ chaque session, en entier« Aucune clé secrète écrite dans le code »
SkillUne procédure ou un savoir à utiliser au bon momentLa description toujours, le reste à la demande« Comment on vérifie une page avant de la publier »
MCPUne prise vers un outil extérieurLes noms des outils au démarrageLire votre agenda, interroger votre outil de paiement
Sous-agentUn assistant qui travaille dans son propre espace et rend un résuméQuand Claude lui confie une tâchePasser 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 :

  • /doctor fait un bilan de votre installation et propose des corrections, en demandant votre accord avant de changer quoi que ce soit ;
  • /code-review relit les modifications en cours pour y chercher des erreurs ;
  • /run et /verify lancent votre application pour vérifier qu'un changement fonctionne vraiment, pas seulement sur le papier ;
  • /loop relance 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

EmplacementCheminOù il sert
Personnel.claude/skills/<nom>/SKILL.md dans votre dossier utilisateurTous vos projets sur cet ordinateur
Projet.claude/skills/<nom>/SKILL.md à la racine du projetCe projet seulement ; à partager avec le projet si vous travaillez à plusieurs
Plugindans le dossier skills/ d'un plugin installéPartout où le plugin est activé, sous le nom /plugin:skill
Compte claude.airéglages des skills sur claude.ai, ou Customize dans l'application de bureauL'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.

À lire aussi

Passer à l'action

Créer votre application avec l'IA

Questions fréquentes

Vos questions, mes réponses

Quelle est la différence entre un skill et le fichier CLAUDE.md ?

Le fichier CLAUDE.md est lu en entier au début de chaque session : il porte ce que Claude doit toujours savoir. Un skill n'est chargé que lorsqu'il sert ; seule sa description est présente en permanence. Les procédures longues et occasionnelles vont donc dans des skills, les règles permanentes dans CLAUDE.md.

Où sont rangés les skills de Claude Code ?

Dans un dossier par skill, qui contient un fichier SKILL.md. Les skills personnels vont dans le dossier .claude/skills de votre dossier utilisateur et servent dans tous vos projets sur cet ordinateur ; ceux d'un projet vont dans .claude/skills à la racine du projet. Les skills activés sur votre compte claude.ai sont aussi chargés dans les sessions du terminal où vous êtes connecté avec ce compte.

Comment appeler un skill ?

En tapant / suivi de son nom au début de votre message, par exemple /avant-publication. Claude peut aussi le déclencher seul quand votre demande correspond à sa description, sauf si le skill contient la ligne disable-model-invocation: true.

Pourquoi Claude n'utilise-t-il pas mon skill ?

Vérifiez d'abord que la description contient les mots que vous employez dans vos demandes, et ajoutez-les au besoin. Puis vérifiez que le skill apparaît quand vous demandez « What skills are available? » ou avec la commande /skills, ou appelez-le directement avec /nom-du-skill. Un en-tête mal formé empêche aussi Claude de lire la description.

Les skills de Claude Code marchent-ils dans d'autres outils ?

Les skills de Claude Code suivent la norme ouverte Agent Skills, utilisée par plusieurs outils d'IA. Les champs de base sont communs ; certains réglages, comme le contrôle de qui déclenche le skill, sont propres à Claude Code.

Un skill téléchargé sur internet peut-il être dangereux ?

Il faut le lire avant de l'installer. Un skill peut contenir des lignes de commande que Claude Code exécute au moment où le skill est chargé, pour injecter un résultat dans les instructions, et il peut pré-autoriser certains outils. Ne gardez que ceux dont vous comprenez chaque ligne, ou demandez à Claude de vous expliquer ce que fait un skill avant de l'ajouter.

Frédéric Lemonnier
L'auteur

Frédéric Lemonnier

Head of Growth · Fondateur de FL POWER

Quinze ans d'acquisition grand public, 3 M€ de budget publicitaire pilotés en direct. Ancien directeur technique, je construis aujourd'hui mes produits en pilotant l'IA : dix applications web et mobiles mises en ligne depuis janvier 2026. Basé à Montpellier.

FL POWER, mon agence