Créer votre première compétence

Ce que vous apprendrez

Durée estimée : 20 minutes

À la fin de cette leçon, vous serez capable de :

Créer une compétence à partir de zéro avec une structure de frontmatter appropriée
Tester et vérifier qu'une compétence se charge correctement dans Claude Code
Expliquer comment Claude Code fait correspondre les demandes entrantes aux compétences disponibles
Décrire la hiérarchie des priorités des compétences (Enterprise, Personal, Project, Plugins)

(4 minutes)

Cette vidéo vous guide dans la création d'une compétence à partir de zéro — une compétence personnelle de description de PR qui fonctionne sur tous vos projets. Vous verrez exactement comment structurer le fichier SKILL. md, le tester et comprendre comment Claude Code découvre et fait correspondre les compétences à vos demandes. La vidéo couvre également la hiérarchie des priorités qui détermine quelle compétence gagne en cas de conflit de noms.

Points clés à retenir

Une compétence est un **répertoire contenant un fichierSKILL. md** avec des métadonnées (nom, description) en frontmatter et des instructions en dessous
Claude charge uniquement les noms et descriptions des compétences au démarrage, puis fait correspondre les demandes entrantes par rapport à ces descriptions en utilisant la correspondance sémantique
Vous recevez une invite de confirmation avant que Claude charge le contenu complet de la compétence dans le contexte
Priorité pour les conflits de noms : Enterprise → Personal → Project → Plugins
Pour mettre à jour une compétence, modifiez son SKILL. md. Pour en supprimer une, supprimez son répertoire. Redémarrez toujours Claude Code pour que les modifications prennent effet

Parcourons la création d'une compétence à partir de zéro, puis examinons comment Claude Code charge et fait correspondre les compétences en coulisse.

Créer une compétence

Nous allons créer une compétence personnelle qui enseigne à Claude comment écrire des descriptions de PR dans un format cohérent. Puisqu'il s'agit d'une compétence personnelle, elle se trouve dans votre répertoire personnel et fonctionne sur tous vos projets.

Commencez par créer un répertoire pour votre compétence dans le dossier des compétences. Le nom du répertoire doit correspondre au nom de votre compétence :

mkdir -p ~/. claude/skills/pr-description

Ensuite, créez un fichier SKILL. md dans ce répertoire. Le fichier a deux parties séparées par des tirets de frontmatter :

--- name: pr-description description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request. ---

When writing a PR description:

Run git diff main... HEAD to see all changes on this branch
Write a description following this format:

What

One sentence explaining what this PR does.

Why

Brief context on why this change is needed

Changes

Bullet points of specific changes made
Group related changes together
Mention any files deleted or renamed

Le nom identifie votre compétence. La description indique à Claude quand l'utiliser — c'est le critère de correspondance. Tout ce qui suit le deuxième ensemble de tirets est les instructions que Claude suit lorsque la compétence est activée.

Tester votre compétence

Claude Code charge les compétences au démarrage, donc redémarrez votre session après en avoir créé une. Vous pouvez vérifier qu'elle est disponible en consultant la liste des compétences disponibles.

Vous devriez voir votre compétence listée. Pour la tester, apportez quelques modifications sur une branche et dites quelque chose comme « write a PR description for my changes ». Claude indiquera qu'il utilise la compétence de description de PR, vérifiera votre diff et écrira une description suivant votre modèle — le même format à chaque fois.

Comment fonctionne la correspondance des compétences

Lorsque Claude Code démarre, il analyse quatre emplacements pour les compétences mais charge uniquement le nom et la description — pas le contenu complet. C'est un détail important.

Lorsque vous envoyez une demande, Claude compare votre message par rapport aux descriptions de toutes les compétences disponibles. Par exemple, « explain what this function does » correspondrait à une compétence décrite comme « explain code with visual diagrams » car l'intention se chevauche.

Une fois qu'une correspondance est trouvée, Claude vous demande de confirmer le chargement de la compétence. Cette étape de confirmation vous tient informé du contexte que Claude extrait. Après votre confirmation, Claude lit le fichier SKILL. md complet et suit ses instructions.

Priorité des compétences

Si vous clonez un référentiel qui a une compétence portant le même nom qu'une de vos compétences personnelles, laquelle gagne ? Il y a un ordre de priorité clair :

Enterprise — paramètres gérés, priorité la plus élevée
Personal — votre répertoire personnel (~/. claude/skills)
Project — le répertoire . claude/skills à l'intérieur d'un référentiel
Plugins — plugins installés, priorité la plus basse

Cela permet aux organisations d'appliquer des normes par le biais de compétences d'entreprise tout en permettant une personnalisation individuelle. Si votre entreprise a une compétence d'entreprise « code-review » et que vous créez une compétence personnelle « code-review » portant le même nom, la version d'entreprise prend précédence.

Pour éviter les conflits, utilisez des noms descriptifs. Au lieu de simplement « review », utilisez quelque chose comme « frontend-review » ou « backend-review ».

Mettre à jour et supprimer des compétences

Pour mettre à jour une compétence, modifiez son fichier SKILL. md. Pour en supprimer une, supprimez son répertoire. Redémarrez Claude Code après toute modification pour que les changements prennent effet.

Réflexion sur la leçon

Quelle est une tâche de votre flux de travail quotidien que vous pourriez transformer en compétence dès maintenant ? À quoi ressemblerait la description ?
Comment la hiérarchie des priorités pourrait-elle affecter la stratégie de gestion des compétences de votre équipe ? Vous fieriez-vous davantage aux compétences personnelles ou au niveau du projet ?

Prochaines étapes

Dans la leçon suivante, vous apprendrez les options de configuration avancées, notamment les champs de métadonnées, les restrictions d'outils avec allowed-tools, et comment structurer les compétences plus grandes en utilisant la divulgation progressive et l'organisation multi-fichiers.

Retours

Au fur et à mesure que vous progressez dans le cours, nous aimerions entendre comment vous utilisez les compétences dans votre travail, ainsi que tout retour que vous pourriez avoir. Partagez vos retours ici.