Créer votre première skill

Créer votre première skill

Points clés à retenir

• Une skill est un répertoire contenant un fichier SKILL.md avec des métadonnées (nom, description) dans le frontmatter et des instructions en dessous
• Claude charge uniquement les noms et descriptions des skills au démarrage, puis fait correspondre les requêtes entrantes à ces descriptions à l'aide d'une correspondance sémantique
• En cas de correspondance, une skill ne comportant qu'un nom, une description et des instructions se charge entièrement sans vous demander votre avis. Si une skill pré-approuve des outils ou ajoute des hooks, Claude Code peut d'abord vous demander votre approbation
• Priorité en cas de conflit de noms : Enterprise → Personal → Project. Les skills de plug-in sont namespacées, elles se chargent donc aux côtés d'une skill portant le même nom
• Pour mettre à jour une skill, modifiez son fichier SKILL.md. Pour en supprimer une, supprimez son répertoire. Claude Code prend en compte la modification dans la session en cours, sans redémarrage. Si ~/.claude/skills est nouveau dans cette session, exécutez /reload-skills après chaque modification

Passons en revue la création d'une skill à partir de zéro, puis examinons comment Claude Code charge et fait réellement correspondre les skills en coulisses.

Créer une skill

Nous allons créer une skill personnelle qui apprend à Claude comment rédiger des descriptions de PR dans un format cohérent. Comme il s'agit d'une skill personnelle, elle se trouve dans votre répertoire personnel et fonctionne dans tous vos projets.

Commencez par créer un répertoire pour votre skill dans le dossier skills. Le nom du répertoire doit correspondre au nom de votre skill :

Créez ensuite un fichier SKILL.md dans ce répertoire. Le fichier comporte deux parties séparées par les tirets du 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:

1. Run `git diff main...HEAD` to see all changes on this branch
2. 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 skill. La description indique à Claude quand l'utiliser — c'est le critère de correspondance. Tout ce qui suit la deuxième série de tirets correspond aux instructions que Claude suit lorsque la skill est activée.



Tester votre skill

Claude Code surveille vos répertoires de skills, de sorte qu'une nouvelle skill est disponible dans la session en cours sans redémarrage. Si ~/.claude/skills n'existait pas au démarrage de la session, Claude Code ne le surveille pas encore, exécutez donc /reload-skills maintenant, puis à nouveau après chaque modification ultérieure. Vous pouvez vérifier que votre skill est disponible en consultant la liste des skills disponibles.



Vous devriez voir votre skill apparaître dans la liste. Pour la tester, effectuez quelques modifications sur une branche et dites quelque chose comme « rédige une description de PR pour mes modifications ». Claude indiquera qu'il utilise la skill de description de PR, vérifiera votre diff, et rédigera une description suivant votre modèle — le même format à chaque fois.

Comment fonctionne la correspondance des skills

Au démarrage, Claude Code analyse plusieurs emplacements à la recherche de skills, mais ne charge que le nom et la description, pas le contenu complet. C'est un détail important.

Lorsque vous envoyez une requête, Claude compare votre message aux descriptions de toutes les skills disponibles. Par exemple, « explique ce que fait cette fonction » correspondrait à une skill décrite comme « expliquer le code à l'aide de diagrammes visuels », car l'intention se recoupe.

Une fois qu'une correspondance est trouvée, Claude lit le fichier SKILL.md complet et suit ses instructions. Une skill ne comportant qu'un nom, une description et des instructions (comme pr-description) se charge sans vous demander votre avis. Si une skill pré-approuve des outils ou ajoute des hooks, Claude Code peut vous demander de l'approuver au préalable, selon votre mode d'autorisation. La vidéo ci-dessus et l'image ci-dessous montrent l'étape d'approbation que Claude Code v2.1.19 a supprimée pour des skills comme pr-description.



Priorité des skills

Si vous clonez un dépôt contenant une skill portant le même nom que l'une de vos skills personnelles, laquelle l'emporte ? Il existe un ordre de priorité clair :

1. Enterprise — paramètres gérés, priorité la plus élevée
2. Personal — votre répertoire personnel (~/.claude/skills)
3. Project — le répertoire .claude/skills à l'intérieur d'un dépôt

Cela permet aux organisations d'imposer des standards via des skills d'entreprise tout en permettant une personnalisation individuelle. Si votre entreprise dispose d'une skill d'entreprise « code-review » et que vous créez une skill personnelle « code-review » portant le même nom, la version d'entreprise prévaut. Les skills provenant de plug-ins installés se situent en dehors de cet ordre. Elles sont namespacées sous la forme /plugin-name:skill-name, de sorte qu'une skill de plug-in et une autre skill portant le même nom se chargent toutes les deux.

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 skills

Pour mettre à jour une skill, modifiez son fichier SKILL.md. Pour en supprimer une, supprimez son répertoire. Claude Code prend en compte la modification dans la session en cours, vous n'avez donc pas besoin de redémarrer. Si vous avez exécuté /reload-skills plus tôt dans cette session parce que ~/.claude/skills était nouveau, exécutez-le à nouveau après chaque modification.

Réflexion sur la leçon

• Quelle tâche de votre flux de travail quotidien pourriez-vous transformer en skill dès maintenant ? À quoi ressemblerait la description ?
• Comment la hiérarchie de priorité pourrait-elle affecter la stratégie de gestion des skills de votre équipe ? Vous appuieriez-vous davantage sur des skills personnelles ou des skills au niveau du projet ?

Et ensuite ?

Dans la prochaine leçon, vous découvrirez des options de configuration avancées, notamment les champs de métadonnées, la pré-approbation d'outils avec allowed-tools, et comment structurer des skills plus volumineuses à l'aide de la divulgation progressive et d'une organisation multi-fichiers.