Un fichier SKILL.md est au cœur de chaque Skill Claude - un fichier Markdown qui commence par un court en-tête YAML (un name et une description), suivi des instructions que Claude doit respecter. La description indique à Claude quand utiliser le Skill ; le corps lui indique comment.
Si vous avez déjà vu ce terme et vous êtes demandé ce qu'il contient réellement, voici l'anatomie d'un SKILL.md, pourquoi chaque partie est importante et comment en rédiger un qui fonctionne.
Qu'est-ce que SKILL.md ?
Un Skill Claude est un dossier, et SKILL.md est le fichier obligatoire à sa racine. Il s'agit d'un simple fichier Markdown, qui s'ouvre dans n'importe quel éditeur de texte. Claude le lit pour apprendre une capacité - les étapes, règles et bonnes pratiques propres à un type de tâche. Des éléments facultatifs (modèles, scripts, fichiers de référence) peuvent se trouver dans le même dossier, mais le SKILL.md est le seul fichier que chaque Skill doit obligatoirement contenir.
Vous souhaitez voir un SKILL.md bien défini plutôt que d'en créer un à partir de zéro ? Le frontmatter et les instructions de Yuri sont déjà rédigés et testés pour détecter les bugs, les failles de sécurité et les problèmes de performance lors d'une revue.
Voir Yuri - Skill AI de revue de code →Les deux parties d'un SKILL.md
1. Le frontmatter (métadonnées)
Tout en haut se trouve un petit bloc YAML entre des marqueurs ---. Il contient les métadonnées essentielles - au minimum un name et une description :
---
name: rapport-hebdomadaire
description: Met en forme des notes brutes dans notre rapport hebdomadaire standard. À utiliser lorsque l'utilisateur demande une mise à jour hebdomadaire, un rapport d'état ou de « rédiger le bilan de la semaine ».
---Ce bloc est spécial : lorsqu'une session démarre, Claude ne précharge que le nom et la description de chaque Skill installé - pas l'intégralité du fichier. Cela permet de garder une fenêtre de contexte légère et explique pourquoi la description joue un rôle si important.
2. Le corps (instructions)
Sous le frontmatter, en Markdown standard, vous indiquez ce que Claude doit réellement faire - idéalement sous forme d'étapes claires et numérotées, avec les règles ou exemples nécessaires :
## Étapes
1. Regroupez les notes sous les rubriques Réussites, En cours et Bloquants.
2. Limitez chaque puce à une phrase, au passé.
3. Terminez par un résumé « La semaine prochaine » sur une seule ligne.
4. N'inventez jamais de métriques qui ne figurent pas dans les notes.Pourquoi la description est la ligne la plus importante
Le déclenchement dépend entièrement de la description. Pendant que vous travaillez, Claude compare votre demande à la description de chaque skill et ne charge le fichier complet qu'en cas de correspondance. Une description vague (« aide à rédiger des rapports ») se déclenche rarement. Une description précise (« à utiliser lorsque l'utilisateur demande une mise à jour hebdomadaire ou un rapport d'avancement ») se déclenche de manière fiable. Si vous ne devez retenir qu'une règle, retenez celle-ci : rédigez la description pour indiquer quand utiliser la skill, et pas seulement ce qu'elle est.
Comment Claude utilise le fichier
- Au démarrage : Claude lit le nom et la description de chaque skill.
-
Pendant la tâche : si votre demande correspond à une description, Claude charge le
SKILL.mdcomplet de cette skill, ainsi que toutes les ressources associées. - Ensuite : Claude suit les instructions du corps du fichier pour effectuer le travail.
Cette approche consistant à ne la charger qu'en cas de besoin s'appelle la divulgation progressive, et c'est ce qui vous permet de garder de nombreuses skills installées sans surcharger le contexte du modèle.
Écrire un bon SKILL.md
- Soignez la description. Indiquez clairement quand la skill doit se déclencher.
- Gardez la première version concise. Cinq à dix lignes d'étapes claires valent mieux qu'un document interminable.
- Soyez concret. Des étapes numérotées, des règles explicites et un court exemple.
- Testez-la sur de vraies tâches. Développez-la uniquement lorsque Claude ne réussit pas.
Devez-vous en écrire une vous-même ?
Non. Écrire le vôtre est idéal pour les workflows qui vous sont propres, mais si vous voulez simplement le résultat, les skills prêtes à l'emploi sont fournies avec leur SKILL.md déjà rédigé et testé. Parcourez la bibliothèque KissMySkills de plus de 1 000 skills, packs de prompts et agents, ou consultez la collection de skills Claude Code. Vous voulez d'abord en voir une en action ? Essayez un générateur gratuit ou procurez-vous une skill gratuite.
Tous les fichiers SKILL.md ne sont pas destinés aux codeurs - le frontmatter et les instructions de Ryan sont conçus pour les dossiers de conseil d'administration, les mémos pour réunions générales et les briefings de direction, sans modification nécessaire.
Voir le Skill AI Ryan - Chief of Staff →Questions fréquemment posées
SKILL.md est-il simplement du Markdown ?
Oui - c'est un fichier Markdown standard avec un bloc de frontmatter YAML en haut. Il s'ouvre dans n'importe quel éditeur de texte, aucun logiciel spécial n'est requis.
Que faut-il dans un fichier SKILL.md ?
Au minimum, un bloc de frontmatter avec un nom et une description. Le corps contenant les instructions rend le Skill utile, mais ce sont les métadonnées qui le rendent détectable et déclenchable.
Où placer le fichier SKILL.md ?
À la racine du dossier du Skill. Dans Claude Code, les Skills se trouvent ~/.claude/skills/<name>/ pour un usage personnel ou .claude/skills/<name>/ dans un projet, avec SKILL.md à la racine du dossier.
Puis-je utiliser le contenu d'un fichier SKILL.md dans ChatGPT ou Gemini ?
Oui. Les instructions sont portables - collez le corps du fichier dans les instructions personnalisées de ChatGPT ou Gemini pour obtenir le même comportement. Le déclenchement automatique via le frontmatter est une fonctionnalité de Claude.
En résumé :
Si vous préférez éviter d'écrire vous-même le frontmatter YAML, Yuri - Code Reviewer est un excellent choix pour les développeurs, tandis que Ryan - Chief of Staff couvre la rédaction de documents pour les cadres et les entreprises. Tous fonctionnent dans Claude, ChatGPT et n'importe quel chat AI, sans codage, avec une garantie de remboursement de 30 jours.
Commencez par un exemple fonctionnel
Le moyen le plus rapide de comprendre SKILL.md est d'en lire un bon. Téléchargez un Skill gratuit, ouvrez le fichier et observez la structure « frontmatter + étapes » en action - puis lisez comment l'installer en trois minutes.
