Qu'est-ce qu'un skill ?
Mis à jour le 29 juillet 2026
Objectifs
À l’issue de cette leçon, vous serez capable de :
- Définir ce que sont les skills de Claude Code et comment ils fonctionnent
- Expliquer où ils se trouvent (répertoire personnel vs. projet)
- Distinguer les skills de CLAUDE.md et des commandes slash
- Identifier les cas où un skill est l’outil de personnalisation adapté
Pourquoi les skills existent
Observez votre semaine de travail avec Claude Code. Lundi, vous lui expliquez vos conventions de code avant de lui confier un module. Mardi, avant une revue de pull request, vous re-décrivez la structure de commentaires que votre équipe attend. Mercredi, vous rappelez une fois de plus le format de vos messages de commit. Chacune de ces explications est correcte, chacune fonctionne, et chacune disparaît à la fin de la session. Les skills existent précisément pour rompre ce cycle : un skill est un fichier Markdown qui apprend à Claude comment faire quelque chose une seule fois, et Claude applique ensuite ces instructions automatiquement, dès que la situation s’y prête.
Ce qu’est un skill
Un skill se matérialise par un dossier contenant des instructions et des ressources que Claude Code découvre au démarrage. Le cœur de ce dossier est un fichier SKILL.md dont le frontmatter porte deux informations : un nom et une description. La description n’est pas décorative, c’est le critère de déclenchement. Quand vous demandez une revue de PR, Claude compare votre requête aux descriptions de tous les skills disponibles et active ceux qui correspondent.
---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---Sous ce frontmatter, vous écrivez les instructions concrètes : votre checklist de revue, vos préférences de formatage, ou tout ce dont Claude a besoin pour mener la tâche comme vous l’entendez. Le fichier ci-dessus, complété par une dizaine de lignes de checklist, remplace définitivement l’explication du mardi matin.
Où se trouvent les skills
L’emplacement du dossier détermine qui en bénéficie. Placés dans ~/.claude/skills, dans votre répertoire personnel, les skills vous suivent d’un projet à l’autre : votre style de commit, votre format de documentation, la façon dont vous aimez qu’on vous explique du code. Placés dans .claude/skills à la racine d’un dépôt, ils deviennent des skills de projet : toute personne qui clone le repo les reçoit automatiquement, sans installation. C’est là que vivent les standards d’équipe, versionnés et partagés comme le reste du code.
Sur Windows, les skills personnels se trouvent dans
C:/Users/<votre-user>/.claude/skills.
Skills, CLAUDE.md et commandes slash
Claude Code offre plusieurs moyens de modifier son comportement, et la question n’est pas de choisir le meilleur mais d’affecter chaque besoin au bon mécanisme.
| Mécanisme | Chargement | Usage |
|---|---|---|
| CLAUDE.md | Dans chaque conversation | Standards permanents du projet (ex: toujours utiliser TypeScript strict) |
| Skills | À la demande, quand la requête correspond | Expertise spécifique à une tâche (ex: checklist de revue de PR) |
| Commandes slash | Invocation explicite par l’utilisateur | Actions ponctuelles déclenchées manuellement |
La spécificité des skills tient à leur économie de contexte. Au démarrage, Claude ne charge que le nom et la description de chacun, jamais le contenu complet. Votre checklist de revue, qui fait peut-être cent lignes, n’occupe donc aucune place pendant que vous déboguez un test qui échoue : elle arrive dans la conversation au moment précis où vous demandez une revue, et pas avant.
Reconnaître un skill qui attend d’être écrit
Les skills servent au mieux les connaissances spécialisées attachées à une tâche identifiable. Les standards de revue de code de votre équipe en sont l’exemple canonique, tout comme le format de vos messages de commit, la charte graphique de votre organisation appliquée aux composants d’interface, vos templates de documentation, ou une checklist de débogage propre à un framework que vous seul maîtrisez vraiment dans l’équipe. Le point commun de ces cas : la connaissance est précieuse mais elle ne concerne qu’une fraction de vos échanges.
La règle de décision tient en une phrase : si vous vous retrouvez à expliquer la même chose à Claude à répétition, c’est un skill qui attend d’être écrit. Prenez quelques minutes pour parcourir vos dernières sessions avec Claude Code et repérer l’instruction que vous avez retapée le plus souvent — c’est votre premier candidat, et vous l’écrirez dès la leçon suivante. Élargissez ensuite la question à votre équipe : parmi vos standards et vos processus, lesquels gagneraient le plus à être encodés une bonne fois plutôt que transmis oralement ?