Les skills

Une skill est une procédure ou un savoir que vous écrivez une fois et que Claude réutilise. Créez-en une quand vous recollez sans cesse les mêmes instructions, la même liste de vérification ou la même procédure en plusieurs étapes, ou quand une partie de votre CLAUDE.md est devenue une procédure plutôt qu’un fait. Une skill s’appelle comme une commande (/nom-de-la-skill), et Claude peut aussi la charger de lui-même quand elle correspond à la demande.

Pourquoi une skill plutôt que CLAUDE.md

Le contenu de CLAUDE.md est chargé à chaque session, qu’il serve ou non. Une skill, elle, ne coûte presque rien tant qu’elle ne sert pas : au démarrage, Claude ne voit que son nom et sa description ; il ne lit le fichier complet qu’au moment où la tâche l’exige. Une longue procédure de mise en production ou un manuel d’incident peuvent donc vivre dans une skill sans peser sur chaque conversation.

Les skills ont aussi absorbé les anciennes commandes personnalisées : un fichier .claude/commands/deploy.md et une skill .claude/skills/deploy/SKILL.md créent tous deux /deploy. Les fichiers de commandes existants continuent de fonctionner, mais les skills ajoutent un dossier pour des fichiers annexes et un contrôle de qui peut les déclencher. Elles suivent le standard ouvert Agent Skills (agentskills.io), commun à plusieurs outils d’IA.

Créer votre première skill

L’exemple officiel crée une skill qui résume les modifications non commitées et signale ce qui paraît risqué. Créez le dossier :

mkdir -p ~/.claude/skills/summarize-changes

Puis écrivez ~/.claude/skills/summarize-changes/SKILL.md :

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.

Le fichier a deux parties : l’en-tête YAML, dont la description indique à Claude quand utiliser la skill, et le corps, les instructions qu’il suit. Le nom du dossier devient la commande. La ligne !`git diff HEAD` est une injection de contexte dynamique : Claude Code exécute la commande et remplace la ligne par sa sortie avant que Claude ne lise la skill, qui arrive donc avec le diff réel.

Testez-la de deux façons : en posant une question qui correspond à la description (« qu’est-ce que j’ai modifié ? »), ou en l’appelant directement avec /summarize-changes.

Où ranger une skill

Qui déclenche la skill

Par défaut, vous et Claude pouvez déclencher n’importe quelle skill. Deux champs d’en-tête restreignent cela :

• disable-model-invocation: true : seul vous pouvez la lancer. C’est le bon réglage pour tout ce qui a des effets de bord ou dont vous voulez choisir le moment, comme /commit ou /deploy : vous ne voulez pas que Claude décide de déployer parce que le code lui semble prêt.
• user-invocable: false : seul Claude peut la charger. C’est utile pour un savoir de fond qui n’est pas une action, comme l’explication du fonctionnement d’un vieux système.

Les skills fournies avec Claude Code

Claude Code inclut des skills prêtes à l’emploi. Vous en avez croisé dans ce cours : /code-review pour la revue de code, /verify pour lancer l’application et vérifier le résultat, /doctor pour diagnostiquer votre installation.

Une skill fiable

Si une skill ne se déclenche pas, la cause est presque toujours sa description : elle doit dire clairement quand l’utiliser, avec les mots que vous emploierez dans vos demandes. Si elle se déclenche trop souvent, resserrez-la. Le cours Introduction aux Agent Skills du catalogue approfondit l’écriture, les fichiers annexes et la diffusion en équipe.

À vous de jouer

Votre première skill. Créez .claude/skills/summarize-changes/SKILL.md, qui résume les modifications non commitées en trois points. Lancez-la avec /summarize-changes, puis ajoutez disable-model-invocation: true et vérifiez que Claude ne la déclenche plus de lui-même.

Sources officielles : Skills (Claude Academy) · Extend Claude with skills · Best practices

Points clés à retenir

• Une skill est un dossier avec un SKILL.md : un en-tête (dont la description) et des instructions
• Seuls le nom et la description sont chargés au départ ; le contenu complet ne coûte qu’au moment de l’usage
• /nom-de-la-skill l’appelle ; Claude peut aussi la charger seul si la demande correspond à la description
• disable-model-invocation: true pour les actions à effets de bord comme /deploy ; user-invocable: false pour un savoir de fond
• Les anciennes commandes .claude/commands/ fonctionnent toujours, mais les skills les remplacent