Anatomie d'un SKILL.md
Pour écrire ou juger une skill, il faut savoir lire le fichier qui la compose et le rôle de chacune de ses parties. Cette leçon vous apprend à décrypter la structure d'un SKILL.md, à comprendre ce que règlent ses principaux paramètres et à savoir ce qui restera utilisable si vous changez d'outil.
Mis à jour le 28 septembre 2026.
En bref
Un SKILL.md commence par un frontmatter YAML qui contient au minimum un nom et une description, suivi d'instructions en Markdown, éventuellement accompagnées de fichiers annexes dans le même dossier. La description décide quand la skill sert, le corps dit comment travailler. Pour un PM, savoir lire ce fichier permet de juger une skill avant de l'adopter.
Objectif de la leçon
À la fin de cette leçon, vous serez capable d'identifier les parties d'une skill (frontmatter, corps, fichiers de référence), d'expliquer le rôle des principaux champs du frontmatter, dont allowed-tools, et de dire ce qui reste portable d'un outil à l'autre.
Les questions auxquelles cette leçon répond
Comment est structuré un fichier SKILL.md ?
Un en-tête YAML placé tout en haut du fichier, avec le nom et la description, puis un corps en Markdown qui donne les instructions. Scripts, modèles et exemples peuvent vivre dans des fichiers à côté.
À quoi sert le champ allowed-tools dans le frontmatter d'une skill ?
Dans Claude Code, allowed-tools liste les outils que la skill peut utiliser sans demander de permission à chaque fois. Il n'interdit pas les autres outils, qui restent soumis aux règles habituelles.
Une skill écrite pour claude.ai fonctionne-t-elle aussi dans Claude Code ?
Le format SKILL.md est le même, donc les instructions se transportent. Certains champs, comme allowed-tools, ne s'appliquent que dans Claude Code, et l'accès aux fichiers ou au réseau varie selon l'environnement.
Thèmes abordés
- SKILL.md
- frontmatter
- allowed-tools
- structure d'une skill
- portabilité des skills
Dans le glossaire
Guides sur ce thème
- Claude Skills : créer et tester une skill
Anatomie d’un SKILL.md, installation, déclenchement, tests et sécurité, avec un modèle.
- Claude Skills ou MCP : lequel choisir
Ce qui distingue une skill d’un serveur MCP, quand utiliser l’un, l’autre ou les deux, avec une grille de décision.
Dans quel module
Comprendre les skills et quand les utiliser
Qu'est-ce qu'une skill, comment se charge-t-elle, et quand est-elle le bon outil ?
Leçons du module
- Ce qu'est une skill, et comment Claude la charge
- Skill, CLAUDE.md, subagent, MCP ou hook ?
- Anatomie d'un SKILL.md (cette leçon)
Ce que vous apprendrez dans la formation
Cette leçon fait partie de la formation Créer des Claude Skills fiables pour votre travail produit
Formations liées
- IA & DéveloppementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Travailler avec Claude Code sur un vrai projet : contexte, plan, revue
3 h
- IA & BusinessTout publicAucun pré-requis : accessible à toutes et tous.
Mettre l'IA au travail dans votre entreprise
2 h 10 min
- IA & DéveloppementJuniorQuelques bases utiles : notions de contexte ou du domaine.
Construire et mettre en ligne une app web avec un agent de code IA
2 h 45 min