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. Mise à jour du 22 octobre 2026 : Anthropic a donné le standard (nom, logo, organisation GitHub et domaine agentskills.io) à l'Agentic AI Foundation, sous la Linux Foundation, comme elle l'avait fait pour MCP. Il devient « ouvert, piloté par la communauté et neutre vis-à-vis des éditeurs », maintenu à titre individuel par des ingénieurs d'Anthropic, Google, OpenAI et d'autres. Anthropic compte plus de 70 plateformes d'agents l'ayant intégré (dont ChatGPT, Cursor, GitHub Copilot et VS Code), 1 million de skills publiés et près de 280 millions d'installations, chiffres de l'annonce. Concrètement, ton dossier de skill s'écrit une fois et vaut pour chaque agent qui lit le format. Rien dans l'annonce n'oblige à rejoindre la fondation pour l'utiliser, et elle ne dit pas que les fichiers existants changent.
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