Accueil / Étendre : compétences, MCP, sous-agents, hooks, plugins

Skills : apprendre un workflow à Claude

Une skill encapsule un workflow reproductible dans un fichier SKILL.md, invoquée par une commande slash explicite ou par correspondance automatique sur sa description.

Une skill regroupe un mode opératoire complet dans un seul fichier, SKILL.md, que Claude Code charge comme une notice qu'il sait suivre sans qu'on ait besoin de la retaper à chaque demande. Le fichier vit dans un dossier portant le nom de la skill, et son contenu commence par un bloc d'en-tête en frontmatter, dont le seul champ vraiment recommandé est une description en langage naturel : ce que la skill fait, et dans quelle situation elle doit s'appliquer. Si le champ est omis, Claude Code se rabat sur le premier paragraphe du contenu Markdown pour décider du déclenchement.

Deux façons de la déclencher

Claude invoque une skill de deux manières distinctes. La première est explicite : taper une commande slash portant le nom du dossier, par exemple /verifier-diacritiques pour une skill rangée dans verifier-diacritiques/SKILL.md. La seconde est automatique : au moment de traiter une demande, Claude compare son texte à la description de chaque skill installée, et charge celle dont la description recoupe le mieux le sujet en cours. Aucune skill ne se déclenche sans que sa description mentionne, en substance, la situation qui doit la faire jouer, et une description trop vague ou trop générale ne recoupe rien de précis.

# Exemple illustratif, sur un dossier de démonstration
mkdir -p demo-skill/resumer-changelog
cat > demo-skill/resumer-changelog/SKILL.md <<'EOF'
---
description: Resume les derniers commits d'un depot en un changelog court, a utiliser quand on demande de preparer une note de version.
---
Lis les commits fournis, groupe-les par type, et rends une liste a puces
courte, une ligne par changement notable.
EOF

Ce que Claude ajoute réellement à sa boîte à outils

Une fois la skill chargée, son contenu s'ajoute au tour en cours comme des instructions supplémentaires, au même titre qu'une consigne tapée directement. Rien n'est exécuté à l'avance : c'est le texte du fichier qui guide la réponse, pas un programme séparé qui tournerait en arrière-plan. C'est pourquoi une skill bien écrite ressemble à une note qu'on laisserait à un collègue qui reprend une tâche précise, avec assez de détail pour ne pas avoir à deviner, et assez peu pour rester lisible en une passe.

Le geste qui mérite une skill n'est pas n'importe quel geste : c'est celui qui revient. Une explication donnée une seule fois ne justifie pas le détour par un fichier. Une explication redonnée trois fois dans la même semaine, en revanche, coûte déjà plus cher à répéter qu'à figer une bonne fois. La suite logique, écrire et tester sa propre skill, se trouve dans créer une skill qui devient aussi une commande.