Aller au contenu
Module
Module 2 sur 5Leçon 3 sur 3~15 min

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

Tout le glossaire

Guides sur ce thème

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

  1. Ce qu'est une skill, et comment Claude la charge
  2. Skill, CLAUDE.md, subagent, MCP ou hook ?
  3. 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