Skills : les connaissances que ton agent peut charger

Un skill est un dossier d'instructions que ton agent charge automatiquement dès qu'il correspond à la tâche.

Qu'est-ce qu'un skill ?

Un skill est un dossier qui contient un fichier nommé SKILL.md. Ce fichier contient des instructions. Quand une tâche correspond au skill, Claude charge les instructions de lui-même. Tu peux aussi appeler un skill directement, avec /nom-du-skill.

La structure de SKILL.md

Chaque SKILL.md commence par un en-tête YAML entre deux lignes ---. Cet en-tête contient des champs comme name et description. Vient ensuite le texte proprement dit : les instructions que reçoit Claude. Un skill peut inclure d'autres fichiers dans le même dossier, par exemple un fichier reference.md ou un script. Claude ne charge ces fichiers supplémentaires que quand il en a vraiment besoin.

Skill ou commande slash ?

À l'origine, les commandes slash n'existaient que sous forme de simples fichiers markdown dans .claude/commands/. Ces fichiers fonctionnent toujours. Mais les custom commands ont été fusionnées avec les skills. Un fichier .claude/commands/deploy.md et un skill .claude/skills/deploy/SKILL.md créent tous les deux la même commande /deploy. Un skill peut en plus apporter tout un dossier de fichiers. Et Claude peut le charger automatiquement, dès qu'il correspond à la tâche.

Quand ça vaut le coup d'écrire un skill ?

Tu tapes toujours les mêmes instructions dans le chat ? Une section de ton CLAUDE.md a fini par devenir toute une procédure ? C'est le bon moment pour en faire un skill. Un skill ne charge son texte qu'en cas de besoin. Ça économise du contexte, comparé à un long CLAUDE.md qui se charge toujours en entier.

Où vivent les skills

Personnel : ~/.claude/skills/<nom>/SKILL.md – disponible dans tous tes projets
Projet : .claude/skills/<nom>/SKILL.md – seulement pour ce projet
Plugin : <plugin>/skills/<nom>/SKILL.md – partout où le plugin est actif