Leçon 11 sur 15
Les skills dans Claude Code
11 min de lecture
Points clés de cette leçon
- Un skill encapsule une compétence ou une procédure réutilisable.
- Claude Code mobilise le skill pertinent selon la tâche en cours.
- Les skills versionnés diffusent les bonnes pratiques dans l'équipe.
Les skills permettent d'enseigner à Claude Code des compétences durables et réutilisables. Plutôt que de réexpliquer une procédure à chaque session, vous la capturez une fois.
Qu'est-ce qu'un skill
Un skill est un paquet de savoir-faire : des instructions, parfois accompagnées d'exemples et de fichiers de référence, qui décrivent comment accomplir un type de tâche. Il répond à la question « comment faisons-nous, ici, telle chose ? ».
Exemples de skills imaginables : générer un composant selon les conventions maison, rédiger un message de commit conforme à votre charte, mener une revue de sécurité selon votre checklist, produire une documentation dans votre format habituel.
Un skill, c'est de la connaissance figée
Là où le fichier CLAUDE.md décrit le contexte général du projet, un skill
décrit une procédure précise. Les deux se complètent : contexte d'un côté,
savoir-faire ciblé de l'autre.
Skill, commande, CLAUDE.md : qui fait quoi
Trois mécanismes se ressemblent ; les distinguer évite la confusion.
Le fichier CLAUDE.md fournit le contexte permanent du projet, lu à chaque session.
Une commande personnalisée, vue dans la leçon sur les commandes, s'invoque explicitement pour déclencher une action.
Un skill, lui, est une compétence que l'assistant peut mobiliser quand la tâche s'y prête, sans que vous ayez à le demander mot pour mot. Les frontières exactes entre ces notions évoluent : vérifiez-les sur le site officiel d'Anthropic.
Anatomie d'un skill
Un skill s'organise généralement autour de quelques éléments : un nom et une description claire de ce qu'il couvre, des instructions sur la marche à suivre, et éventuellement des ressources associées.
# Structure illustrative d'un skill dans un dépôt
.claude/
skills/
revue-securite/
SKILL.md # description et instructions
checklist.md # ressource de référenceLa description joue un rôle clé : c'est elle qui aide l'assistant à savoir quand le skill est pertinent. Une description floue rend le skill peu mobilisé ; une description précise le rend utile au bon moment.
Écrire un bon skill
Quelques principes améliorent nettement la qualité d'un skill.
Cibler une compétence à la fois
Un skill « tout faire » est difficile à mobiliser correctement. Préférez des skills étroits : un pour les tests, un pour la documentation, un pour les migrations de base de données.
Être explicite et orienté action
Comme pour un bon CLAUDE.md, restez factuel. Décrivez les étapes, les pièges
à éviter, les conventions à respecter. Évitez les généralités.
Fournir des exemples concrets
Un exemple inventé mais réaliste vaut mieux qu'une longue explication abstraite. Montrez le résultat attendu.
Versionnez vos skills
Un skill placé dans le dépôt profite à toute l'équipe et reste cohérent dans le temps. C'est un excellent moyen de diffuser les bonnes pratiques sans formation répétée.
Skills et sous-agents
Les skills se combinent naturellement avec les sous-agents. Un sous-agent spécialisé peut s'appuyer sur un skill pour mener sa mission selon vos standards. L'un découpe le travail, l'autre apporte le savoir-faire.
Maintenir ses skills
Un skill, comme une documentation, vieillit. Si vos conventions changent, vos skills doivent suivre. Relisez-les périodiquement, supprimez ceux devenus obsolètes et corrigez les instructions dépassées. Un skill erroné fait plus de dégâts qu'une absence de skill.
En résumé
Les skills capturent votre savoir-faire sous une forme réutilisable que Claude Code mobilise au bon moment. Ciblés, explicites, illustrés et versionnés, ils diffusent les bonnes pratiques sans effort répété.
La prochaine leçon traite de l'intégration GitHub. Découvrez aussi les cours et la certification Certified Architect.