Format SKILL.md
Le format SKILL.md est un standard ouvert publié par Anthropic en décembre 2025 sur agentskills.io, un fichier markdown avec frontmatter YAML (description, allowed-tools) qui dit à Claude quand et comment invoquer une compétence ; le champ description est ce qui déclenche le skill, donc c'est là que tu mets ton 'use when' précis. Spécification de fichier markdown qui décrit une compétence Claude Code ou agent : frontmatter YAML obligatoire avec champ description (le signal qui déclenche l'invocation), champs optionnels allowed-tools / disable-model-invocation, puis instructions en markdown lues par Claude au runtime via bash. Compatible Claude Code, OpenAI Codex, OpenClaw, standard ouvert maintenu sur github.com/anthropics/skills.
Forces
- Standard ouvert (agentskills.io, github.com/anthropics/skills), pas verrouillé sur Anthropic, fonctionne dans Codex et OpenClaw
- Brique unitaire : un seul fichier .md, pas de build, pas de versioning obligatoire, démarre en 30 secondes
- Champ description du frontmatter pilote l'invocation automatique, pas besoin de slash command si la description match l'intent
Limites
- La qualité du champ description détermine 100% du routage, un skill avec mauvaise description ne s'invoque jamais
- Pas de versioning natif au niveau SKILL.md, pour la distribution équipe, il faut passer au plugin
Pour qui
- Workflow personnel ou un seul projet, un fichier .skill.md isolé suffit, pas de surcoût plugin
- Devs qui veulent comprendre la mécanique de routage Claude Code avant de packager en plugin