Que sont les compétences ?

Que sont les compétences ?

Points clés à retenir

• Les compétences sont des dossiers d'instructions que Claude Code peut découvrir et utiliser pour traiter les tâches avec plus de précision. Chaque compétence réside dans un fichier SKILL.md avec un nom et une description dans son frontmatter
• Claude utilise la description pour faire correspondre les compétences aux demandes. Lorsque vous demandez à Claude de faire quelque chose, il compare votre demande aux descriptions des compétences disponibles et active celles qui correspondent
• Les compétences personnelles se trouvent dans ~/.claude/skills et vous suivent dans tous vos projets. Les compétences de projet se trouvent dans .claude/skills à l'intérieur d'un dépôt et sont partagées avec toute personne qui le clone
• Les compétences se chargent à la demande — contrairement à CLAUDE.md (qui se charge dans chaque conversation) ou aux commandes slash (qui nécessitent une invocation explicite), les compétences s'activent automatiquement lorsque Claude reconnaît la situation
• Si vous vous surprenez à expliquer la même chose à Claude de manière répétée, c'est qu'une compétence attend d'être rédigée

Chaque fois que vous expliquez les normes de codage de votre équipe à Claude, vous vous répétez. À chaque révision de PR, vous redécrivez comment vous souhaitez que les retours soient structurés. À chaque message de commit, vous rappelez à Claude votre format préféré. Les compétences résolvent ce problème.

Une compétence est un fichier markdown qui apprend à Claude comment faire quelque chose, une seule fois. Claude applique ensuite cette connaissance automatiquement chaque fois que c'est pertinent.

Ce que sont les compétences

Les compétences sont des dossiers d'instructions et de ressources que Claude Code peut découvrir et utiliser pour traiter les tâches avec plus de précision. Chaque compétence réside dans un fichier SKILL.md avec un nom et une description dans son frontmatter.



La description est ce qui permet à Claude de décider s'il doit utiliser la compétence. Lorsque vous demandez à Claude de réviser une PR, il compare votre demande aux descriptions des compétences disponibles et trouve celle qui convient. Claude lit votre demande, la compare à toutes les descriptions de compétences disponibles, et active celles qui correspondent.

Voici à quoi ressemble le frontmatter d'une compétence :

---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---

Sous le frontmatter, vous rédigez les instructions proprement dites — votre liste de vérification de révision, vos préférences de formatage, ou tout ce que Claude doit savoir pour cette tâche.

Où se trouvent les compétences

Vous pouvez stocker les compétences à différents endroits selon qui en a besoin :

• Les compétences personnelles se trouvent dans ~/.claude/skills (votre répertoire personnel). Elles vous suivent dans tous vos projets — votre style de message de commit, votre format de documentation, la façon dont vous aimez que le code soit expliqué.
• Les compétences de projet se trouvent dans .claude/skills à l'intérieur du répertoire racine de votre dépôt. Toute personne qui clone le dépôt obtient automatiquement ces compétences. C'est là que résident les normes de l'équipe, comme les directives de marque de votre entreprise, les polices et couleurs préférées pour la conception web.

Sous Windows, les compétences personnelles se trouvent dans C:/Users/<your-user>/.claude/skills.

Les compétences de projet sont validées dans le contrôle de version avec votre code, de sorte que toute l'équipe les partage.

Compétences vs. CLAUDE.md vs. commandes slash

Claude Code dispose de plusieurs façons de personnaliser son comportement. Les compétences sont uniques car elles sont automatiques et spécifiques à une tâche. Voici comment elles se comparent :

• Les fichiers CLAUDE.md se chargent dans chaque conversation. Si vous voulez que Claude utilise toujours le mode strict de TypeScript, cela va dans CLAUDE.md.
• Les compétences se chargent à la demande lorsqu'elles correspondent à votre demande. Claude ne charge initialement que le nom et la description, de sorte qu'elles ne remplissent pas toute votre fenêtre de contexte. Votre liste de vérification de révision de PR n'a pas besoin d'être dans le contexte lorsque vous déboguez — elle se charge lorsque vous demandez réellement une révision.
• Les commandes slash nécessitent que vous les tapiez explicitement. Ce n'est pas le cas des compétences. Claude les applique lorsqu'il reconnaît la situation.

Lorsque Claude fait correspondre une compétence à votre demande, vous la verrez se charger dans le terminal :



Quand utiliser les compétences

Les compétences fonctionnent mieux pour les connaissances spécialisées qui s'appliquent à des tâches spécifiques :

• Les normes de révision de code que votre équipe suit
• Les formats de message de commit que vous préférez
• Les directives de marque de votre organisation
• Les modèles de documentation pour des types spécifiques de documents
• Les listes de vérification de débogage pour des frameworks particuliers

La règle générale est simple : si vous vous surprenez à expliquer la même chose à Claude de manière répétée, c'est qu'une compétence attend d'être rédigée.

Réflexion sur la leçon

• Pensez à vos interactions les plus récentes avec Claude Code. Quelles instructions vous êtes-vous surpris à répéter ? Comment une compétence aurait-elle pu vous faire gagner du temps ?
• Considérez le flux de travail de votre équipe. Quelles normes ou processus bénéficieraient le plus d'être encodés sous forme de compétences ?

Et ensuite

Dans la prochaine leçon, vous créerez votre première compétence à partir de zéro et apprendrez comment Claude Code découvre, fait correspondre et charge les compétences en coulisses.