Skills Claude Code : comment les créer, avec exemples et bonnes pratiques

Ce que sont les skills Claude Code

Créez une skill quand vous collez sans cesse les mêmes instructions, la même checklist ou la même procédure en plusieurs étapes dans le chat, ou quand une partie de votre CLAUDE.md est passée d’un simple fait à une procédure. Les skills suivent le standard ouvert Agent Skills (agentskills.io), que d’autres outils d’IA lisent aussi ; Claude Code y ajoute des extras comme le contrôle de l’invocation, l’exécution en subagent et la sortie shell en direct dans le prompt.

• Deux façons d’en lancer une : Claude la charge quand votre demande correspond à sa description, ou vous tapez /skill-name.
• Peu coûteuse tant qu’elle ne sert pas : seuls le nom et la description restent dans le contexte ; le corps se charge quand la skill s’exécute. Une skill réservée au lancement manuel n’affiche même pas sa description.
• Les commandes slash personnalisées sont désormais des skills : .claude/commands/<name>.md fonctionne toujours, mais un dossier de skill peut aussi contenir des fichiers annexes. Voir les commandes slash Claude Code.
• Claude Code fournit aussi des skills intégrées, comme /simplify, /loop, /batch et /debug.

Skills, CLAUDE.md, subagents, plugins ou MCP

Comment créer une skill Claude Code

1. Choisissez son emplacement

   ~/.claude/skills/<name>/ pour vous, dans tous vos projets ; .claude/skills/<name>/ dans un dépôt, committé, pour tous ceux qui y travaillent. Le nom du dossier devient la commande : summarize-changes donne /summarize-changes.

2. Écrivez SKILL.md : une description, puis les instructions

   Le frontmatter se place entre deux lignes ---, tout en haut du fichier. Seule description est recommandée : commencez par le cas d’usage et les mots que les gens emploieraient vraiment. En dessous, rédigez les instructions en Markdown. Une ligne commençant par ` !command ` exécute d’abord cette commande et colle sa sortie, pour que la skill parte de votre état réel.

   ---
   description: Résume les modifications non committées et signale tout ce qui est risqué. À utiliser quand l’utilisateur demande ce qui a changé, veut un message de commit ou demande une relecture de son diff.
   ---
   
   ## Modifications en cours
   
   !`git diff HEAD`
   
   ## Instructions
   
   Résume les modifications ci-dessus en deux ou trois puces, puis liste les
   risques éventuels : gestion d’erreurs manquante, valeurs codées en dur ou tests à mettre à jour.

3. Testez-la des deux façons

   Lancez claude dans un projet git avec une modification non committée. Demandez « Qu’est-ce que j’ai changé ? » pour voir si Claude choisit la skill de lui-même, puis tapez /summarize-changes pour la lancer directement. Les skills ajoutées pendant une session se chargent d’elles-mêmes ; lancez /reload-skills si l’une n’apparaît pas.

4. Décidez qui peut la lancer

   Ajoutez disable-model-invocation: true pour tout ce qui a des effets de bord, comme un déploiement ou l’envoi de messages, afin que vous seul puissiez la déclencher. Ajoutez user-invocable: false pour des connaissances de fond que seul Claude doit charger. Passez des entrées avec $ARGUMENTS, comme le montre le guide des commandes slash.

5. Partagez-la

   Committez .claude/skills/ dans le dépôt, ou empaquetez vos skills sous forme de plugin pour plusieurs dépôts ou équipes.

Source : documentation de Claude Code, Extend Claude with skills

Exemples de skills Claude Code

1. Une skill de référence qui ne se charge que pour certains fichiers

   Les skills de référence contiennent des conventions que Claude applique en travaillant. paths limite le chargement automatique aux fichiers qui correspondent aux globs.

   ---
   description: Conventions de conception d’API de ce code. À utiliser pour écrire ou relire des endpoints HTTP.
   paths: ["src/api/**"]
   ---
   
   Pour écrire des endpoints d’API :
   - Utilise des noms RESTful et des ressources au pluriel
   - Renvoie les erreurs sous la forme { error: { code, message } }
   - Valide le corps de la requête avec les schémas de src/api/schemas/

2. Une skill de tâche avec des fichiers annexes

   Gardez SKILL.md court et renvoyez vers le reste. Claude ne lit checklist.md que lorsque SKILL.md le lui demande, et exécute bump.sh sans le lire : les détails ne coûtent rien tant qu’ils ne servent pas.

   release/
   ├── SKILL.md          # les étapes, et quand lire les autres fichiers
   ├── checklist.md      # chargé seulement quand SKILL.md y renvoie Claude
   └── scripts/
       └── bump.sh       # exécuté, pas lu dans le contexte

3. Une skill qui s’exécute dans son propre subagent

   context: fork lance un subagent (ici le type Explore, en lecture seule) avec la skill pour prompt. Il ne voit pas votre conversation, donc les instructions doivent se suffire à elles-mêmes ; il tourne en arrière-plan sauf si vous définissez background: false.

   ---
   description: Auditer les dépendances pour trouver les vulnérabilités connues et les versions majeures en retard
   context: fork
   agent: Explore
   disable-model-invocation: true
   ---
   
   Lance l’audit du gestionnaire de paquets, liste chaque résultat de gravité haute ou
   critique avec la version corrective, et indique quelles versions majeures sont en retard. Ne modifie aucun fichier.

Installer des skills depuis des plugins et des marketplaces

Les skills écrites par d’autres arrivent généralement dans des plugins. Claude Code enregistre la marketplace officielle d’Anthropic (claude-plugins-official) au premier lancement d’une session interactive ; parcourez-la avec /plugin, ou installez directement, par exemple /plugin install skill-creator@claude-plugins-official. Pour une marketplace d’équipe ou communautaire, ajoutez-la d’abord avec /plugin marketplace add owner/repo.

• Les skills de plugin s’appellent /plugin-name:skill-name.
• La marketplace officielle indique le coût en contexte de chaque plugin, par tour et à l’invocation.
• Le plugin skill-creator aide à écrire une skill et lance des évaluations qui comparent les résultats avec et sans elle.
• Lisez les skills d’un dépôt ou d’un plugin avant de leur faire confiance : allowed-tools peut pré-autoriser des outils pendant le tour où une skill s’exécute.

Bonnes pratiques, et quand Claude ignore une skill

• Rédigez la description pour qu’elle soit reconnue : commencez par la tâche et les formulations qu’emploient les utilisateurs. Dans la liste, la description et when_to_use sont tronqués à 1 536 caractères.
• Placez les instructions les plus importantes en haut : après la compaction de la conversation, Claude Code peut ne garder que le début d’une skill invoquée. Invoquez-la à nouveau pour la rétablir.
• Formulez les consignes pour toute la tâche (« lance les tests après chaque modification »), car le fichier de la skill n’est pas relu aux tours suivants. Une règle qui ne doit jamais être sautée a sa place dans un hook.
• Pour réduire la consommation de tokens, sortez les procédures de CLAUDE.md pour en faire des skills, mettez disable-model-invocation: true sur les skills que vous lancez à la main, et consultez /skill-doctor pour repérer les skills qui coûtent du contexte mais servent rarement.
• Elle ne se déclenche pas ? Vérifiez que la description contient les bons mots-clés, demandez « Quelles skills sont disponibles ? », et lancez claude plugin validate .claude/skills pour trouver un frontmatter qui ne se parse pas.
• Elle se déclenche trop souvent ? Resserrez la description, ou passez la skill en mode manuel avec disable-model-invocation: true.

Les skills apprennent à Claude Code comment faire. Crewmark lui donne de quoi faire, toutes les heures.

Une bibliothèque de skills rend chaque session plus compétente, mais elle attend toujours que vous demandiez. Crewmark transforme une session Claude Code, Codex, DeepSeek Harness ou OpenCode en employé IA avec un rôle, un objectif et des horaires de travail, et la réveille à intervalle régulier (heartbeat) pour qu’elle prenne la prochaine issue d’un tableau, avec les skills de votre projet chargées.

1. Gardez vos skills dans le dépôt

   La session de l’employé lit .claude/skills/ et CLAUDE.md comme la vôtre : une skill de release ou une checklist de relecture suivent donc.

2. Laissez la pulsation lancer le travail

   Pendant ses horaires de travail, l’employé se réveille toutes les 15, 30 ou 60 minutes dans la même conversation et prend la prochaine issue ; voir comment rendre Claude Code proactif.

3. Assignez des issues et répondez à ses messages

   Mettez le travail sur le tableau ; l’employé commente au fil de l’eau et vous écrit quand il a besoin d’une décision. Lisez ce qu’est un employé IA.

FAQ skills Claude Code