Aller au contenu
Architecture agentique

Skill (SKILL.md)

Un skill est un dossier d'instructions spécialisées que l'agent ne charge que si la tâche le demande. Il capitalise une procédure répétée, là où AGENTS.md décrit le projet en permanence.

  • skill
  • skill.md
  • agent skills
  • frontmatter
  • expertise
  • procédure

Syntaxe

Modèle
<dossier des skills>/<nom>/SKILL.md     ← un dossier par skill, scripts et modèles joints possibles---name: <nom-en-minuscules-et-tirets>    ← obligatoiredescription: <ce que fait le skill et quand l'utiliser>    ← obligatoire, sert au déclenchement---# Titre## Quand l'utiliser## Étapes## Vérifications

Exemple

Exemple concret
Fichier : .claude/skills/ajout-lecon/SKILL.md---name: ajout-lecondescription: Ajoute une leçon à un parcours Central Campus (module TypeScript, slug unique). À utiliser quand on demande une nouvelle leçon ou un nouvel exercice.---# Ajouter une leçon## Étapes1. Vérifier que le slug est libre : grep -rhoE 'slug: ?"[^"]+"' src/lib2. Créer l'exercice dans src/lib/<parcours>/lessons/modules/3. Ajouter la théorie indexée par le même slug## Vérifications- npx tsc --noEmit et npm run lint sans erreur- la solution s'exécute sur le jeu de données déclaréRésultat attendu : pour « ajoute une leçon sur HAVING », l'agent charge ce skill et suitles étapes ; pour une question de CSS, il ne le charge pas.

À retenir

  1. Emplacements courants : .claude/skills/<nom>/ dans le projet pour Claude Code, ~/.claude/skills/ pour un usage personnel ; Cursor et d'autres outils lisent un dossier équivalent (voir leur documentation). Le format est publié comme format ouvert sous le nom Agent Skills.
  2. Créez un skill après avoir répété trois fois la même procédure ; avant cela, un brief bien structuré suffit.
  3. Le dossier peut contenir des scripts et des modèles que le corps du skill référence : l'agent ne les ouvre que s'il en a besoin, ce qui économise du contexte.
  4. Piège : oublier le frontmatter ou écrire une description vague. Sans name ni description, le skill n'est pas reconnu ; avec « aide au code », il se déclenche n'importe quand (voir la fiche « Déclenchement des skills »).

Voir aussi