Claude Code skills : créer et utiliser des modules d’expertise
Sommaire
▶️ En Bref
Une skill Claude Code est un module d’expertise réutilisable qui encapsule un savoir-faire (revue de code, refactoring, debug, etc.). Une skill = un dossier avec un fichier SKILL.md qui contient les instructions et éventuellement des fichiers ressources. Claude charge automatiquement la skill quand son trigger est détecté. Vous pouvez créer vos propres skills, en partager via ~/.claude/skills/ ou installer celles de la communauté.
Les skills transforment Claude Code en spécialiste sur demande. Au lieu de répéter les mêmes instructions à chaque session (« reviewe le code en respectant ces règles », « refactor selon ces principes »), vous packagez votre expertise une fois et Claude l’applique automatiquement.
Qu’est-ce qu’une skill Claude Code ?
Une skill est un dossier nommé contenant des instructions et ressources que Claude Code charge à la demande. Quand un message utilisateur correspond au trigger défini dans la skill, Claude active ses instructions et applique son expertise.
📖 Skill vs prompt système classique
Un prompt système s’applique à toute la conversation. Une skill ne s’active que lorsque c’est pertinent. Cela évite de polluer le contexte avec des instructions non utilisées et permet d’avoir des dizaines de skills disponibles sans saturation.
Les skills résolvent trois problèmes :
- Réutilisation : votre expertise pour un domaine n’est écrite qu’une fois
- Partage : vous pouvez partager une skill comme un package npm
- Contexte intelligent : Claude n’active que les skills pertinentes à la tâche du moment
Anatomie d’une skill
Une skill minimale contient un seul fichier : SKILL.md.
├── SKILL.md # Instructions et trigger
├── examples/ # Exemples optionnels
└── resources/ # Documentations, templates…
Structure du fichier SKILL.md
Le fichier suit ce format en YAML frontmatter + Markdown :
name: code-reviewer
description: Reviewer un code selon nos règles internes
—
# Code Reviewer Skill
Quand on te demande de reviewer du code :
1. Vérifier la cohérence avec le style guide
2. Repérer les bugs potentiels
3. Suggérer des refactorings
4. Tester les edge cases
…
Les champs name et description sont obligatoires. Le contenu Markdown ensuite décrit le comportement attendu de Claude quand la skill est active.
Créer sa première skill
Étapes pour créer une skill personnalisée :
1. Créer le dossier
cd ~/.claude/skills/ma-skill
L’emplacement standard est ~/.claude/skills/. Toutes les skills là-dedans sont automatiquement disponibles dans toutes vos sessions Claude Code.
2. Écrire le SKILL.md
Choisissez un nom court (lower-case, tirets) et une description précise du trigger — c’est-à-dire dans quels cas la skill doit s’activer.
3. Tester en conversation
Dans une session Claude Code, demandez explicitement la tâche cible. Si votre skill est bien rédigée, Claude l’invoque automatiquement. Sinon, ajustez la description ou le contenu.
💡 Conseil
Une skill bien faite a une description ultra-précise sur les déclencheurs. Plutôt que « aide pour le code », écrivez « reviewer un fichier React après modifications majeures ». Plus c’est précis, plus l’activation est fiable.
Installer des skills externes
De nombreuses skills sont disponibles publiquement sur GitHub et autres registries. Pour installer une skill externe :
La skill est téléchargée dans ~/.claude/skills/ et activée automatiquement.
📝 Attention sécurité
Une skill peut donner des instructions à Claude pour exécuter du code sur votre machine. N’installez que des skills de sources fiables. Lisez le SKILL.md avant d’installer une skill venant d’une source inconnue.
Exemples de skills utiles
Voici des skills populaires que les développeurs utilisent au quotidien :
- code-reviewer : reviewer une PR selon le style guide de l’équipe
- test-driven-development : forcer Claude à écrire le test avant le code
- systematic-debugging : protocole de debug en cas d’erreur (pas de patch, comprendre la cause)
- writing-plans : structurer un plan d’implémentation avant de coder
- frontend-design : générer du frontend production-ready
- security-review : audit sécu sur les changements en cours
- seo-audit : auditer des pages web pour le référencement
Bonnes pratiques de conception
Garder une skill courte et focalisée
Une skill = un savoir-faire précis. Si votre SKILL.md dépasse 200 lignes, c’est probablement deux skills à séparer.
Décrire les triggers avec précision
La description doit contenir des mots-clés que l’utilisateur prononce naturellement. Pour une skill de revue de code : « reviewer », « PR », « pull request », « code review », « audit ».
Inclure des exemples concrets
Les exemples sont plus efficaces que les règles abstraites. Donnez à Claude un avant/après pour qu’il comprenne le résultat attendu.
Versionner sa skill
Mettez votre dossier skill dans Git. Vous pouvez la partager facilement et suivre l’évolution de vos pratiques.
FAQ
Combien de skills puis-je avoir installées ?
Pas de limite stricte. Claude Code charge intelligemment les skills pertinentes par session. Vous pouvez en avoir des dizaines sans impact sur les performances.
Une skill peut-elle exécuter du code ?
Une skill par elle-même ne fait que donner des instructions à Claude. C’est Claude qui exécute (selon vos permissions). Vous gardez toujours le contrôle final.
Skills vs CLAUDE.md, quelle différence ?
CLAUDE.md s’applique toujours, à toute la session. Les skills ne s’activent que sur trigger. Utilisez CLAUDE.md pour le contexte projet (architecture, stack), les skills pour les expertises ponctuelles.
Puis-je désactiver une skill temporairement ?
Oui via la commande /skills. Vous pouvez désactiver une skill spécifique sans supprimer le fichier.
Existe-t-il un marketplace de skills ?
L’écosystème est jeune mais grandit vite. Anthropic et la communauté publient des collections sur GitHub. Recherchez « claude-code-skills » sur GitHub pour découvrir les plus populaires.
✅ Ce qu’il faut retenir
- Une skill = un dossier avec SKILL.md (frontmatter YAML + instructions Markdown)
- Emplacement standard :
~/.claude/skills/<nom>/ - Description précise des triggers = activation fiable
- Garder court et focalisé : 1 skill = 1 expertise
- Skills externes :
npx skills addavec source fiable - Compléter avec hooks et MCP pour des workflows avancés
Pour aller plus loin : Comment utiliser Claude Code, Claude Code hooks et Claude Code et MCP.
Envie d’aller plus loin ?
Découvrez nos formations complètes avec accompagnement personnalisé.
Voir la formation%20(1).png)