Un fichier SKILL.md est au cœur de chaque Claude Skill - 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 le term 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 Claude Skill 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, les règles et les bonnes pratiques propres à un type de tâche. Des éléments supplémentaires facultatifs (modèles, scripts, fichiers de référence) peuvent être placés dans le même dossier, mais le SKILL.md est le seul fichier indispensable à tout Skill.
Vous voulez voir un SKILL.md bien délimité 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 performances 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: weekly-report
description: Met en forme des notes brutes pour produire 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 commence, Claude précharge uniquement le nom et la description de chaque Skill installé - pas l’intégralité du fichier. Cela permet de préserver la légèreté de la fenêtre de contexte et explique pourquoi la description joue un rôle si important.
2. Le corps (instructions)
Sous le frontmatter, en Markdown classique, vous écrivez 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 Blocages.
2. Limitez chaque puce à une phrase, au passé.
3. Terminez par un résumé « La semaine prochaine » en une 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, faites-en 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 fichier
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 le charger qu’en cas de besoin » s’appelle la divulgation progressive ; c’est elle qui vous permet de garder de nombreuses skills installées sans gonfler le contexte du modèle.
Rédiger un bon fichier 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 long document tentaculaire.
- Soyez concret. Utilisez des étapes numérotées, des règles explicites et un court exemple.
- Testez-la sur des tâches réelles. Développez-la uniquement là où Claude échoue.
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 obtenir le résultat, les skills prêtes à l’emploi sont livrées avec leur fichier SKILL.md déjà conçu et testé. Parcourez la bibliothèque KissMySkills, qui propose plus de 1 000 skills, packs de prompts et agents, ou consultez la collection de skills Claude Code. Vous souhaitez d’abord en voir un à l’œuvre ? Essayez un générateur gratuit ou téléchargez une skill gratuite.
Tous les fichiers SKILL.md ne sont pas destinés aux codeurs : les métadonnées initiales et les instructions de Ryan sont conçues pour les dossiers destinés au conseil d’administration, les notes pour les réunions générales et les briefings de direction, sans modification requise.
Voir le Skill AI de Ryan - Chef de cabinet →Foire aux questions
SKILL.md est-il simplement du Markdown ?
Oui : il s’agit d’un fichier Markdown standard avec un bloc de métadonnées YAML initiales en haut. Il s’ouvre dans n’importe quel éditeur de texte, sans logiciel particulier.
Que faut-il dans un fichier SKILL.md ?
Au minimum, un bloc de métadonnées initiales contenant un nom et une description. Le corps du fichier, qui contient 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 le dossier 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 les métadonnées initiales est une fonctionnalité de Claude.
En résumé :
Si vous préférez éviter d’écrire vous-même les métadonnées YAML initiales, Yuri - Relecteur de code est un excellent choix pour les développeurs, tandis que Ryan - Chef de cabinet couvre la rédaction destinée aux cadres et aux entreprises. Tous fonctionnent dans Claude, ChatGPT et n’importe quel chat AI, sans codage, avec une garantie satisfait ou remboursé 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 associant les métadonnées initiales et les étapes - puis lisez comment l’installer en trois minutes.