Skills (Agent Skills, SKILL.md)

Définition

Format ouvert, créé par Anthropic, pour empaqueter un savoir-faire : un dossier avec un SKILL.md (front-matter name et description au minimum, puis instructions), plus scripts, références et gabarits. Chargement par divulgation progressive : au démarrage seuls nom et description sont lus ; le corps n'entre dans le contexte que si la tâche correspond. Adopté par Claude Code, Cursor, Copilot, Gemini CLI, Codex et d'autres.

Analogie

Des fiches procédures rangées dans un classeur : on lit l'étiquette, on n'ouvre la fiche que quand on en a besoin.

Exemple de code

# .claude/skills/release-notes/SKILL.md
---
name: release-notes
description: Rédige les notes de version à partir des commits depuis le dernier tag. À utiliser quand on prépare une release.
disable-model-invocation: true      # seul l'humain déclenche (/release-notes)
allowed-tools: Bash(git log *) Bash(git tag *)
---
## Commits depuis le dernier tag
!`git log $(git describe --tags --abbrev=0)..HEAD --oneline`

## Consignes
Regroupe en Ajouts / Corrections / Ruptures. Français, une ligne par entrée,
référence PR entre parenthèses. Ne mentionne pas les commits de CI.

Cas d'usage

Procédures récurrentes (release, revue, déploiement staging) partagées dans le dépôt et entre outils.

Anti-pattern

Termes liés

Sources

• agentskills.io/
• code.claude.com/docs/en/skills