Un fichier SKILL.md est le cœur de chaque Claude Skill — un fichier Markdown qui commence par un en-tête YAML court (un nom et une description) suivi des instructions que Claude doit suivre. La description indique à Claude quand utiliser la Skill ; le corps explique comment.
Si vous avez vu ce terme et vous vous demandez ce qu’il contient réellement, voici l’anatomie d’un SKILL.md, pourquoi chaque partie est importante, et comment en écrire un qui fonctionne.
Qu’est-ce que SKILL.md
Un Claude Skill est un dossier, et SKILL.md est le fichier obligatoire à sa racine. C’est du Markdown simple, donc il s’ouvre dans n’importe quel éditeur de texte. Claude le lit pour apprendre une capacité — les étapes, règles et bonnes pratiques pour un type de tâche. Des éléments optionnels (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 que chaque skill doit avoir.
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 nom et une description :
---
name: weekly-report
description: Formate les notes brutes en notre rapport hebdomadaire standard. Utilisez-le lorsque l’utilisateur demande une mise à jour hebdomadaire, un rapport d’état, ou pour "rédiger la semaine."
---Ce bloc est spécial : au démarrage d’une session, Claude charge uniquement le nom et la description de chaque skill installé — pas le fichier complet. Cela allège la fenêtre de contexte et explique pourquoi la description est si importante.
2. Le corps (instructions)
Sous le frontmatter, en Markdown normal, vous écrivez ce que Claude doit réellement faire — idéalement sous forme d’étapes claires et numérotées avec règles ou exemples :
## Étapes
1. Regroupez les notes sous Gains, En cours, et Bloqueurs.
2. Limitez chaque point à une phrase au passé.
3. Terminez par un résumé "Semaine prochaine" en une ligne.
4. Ne jamais inventer 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. En travaillant, Claude compare votre demande à la description de chaque skill et charge le fichier complet seulement si elle correspond. Une description vague (« aide avec les rapports ») se déclenche rarement. Une description précise (« utiliser lorsque l’utilisateur demande une mise à jour hebdomadaire ou un rapport d’état ») se déclenche de manière fiable. Si vous retenez une règle, c’est celle-ci : écrivez la description pour quand utiliser la skill, 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 (et ses ressources associées). - Ensuite : Claude suit les instructions du corps pour accomplir le travail.
Cette approche « charger seulement quand nécessaire » s’appelle la divulgation progressive, et elle 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 courte. Cinq à dix lignes d’étapes claires valent mieux qu’un document trop long.
- Soyez concret. Étapes numérotées, règles explicites, un court exemple.
- Testez sur des tâches réelles. Élargissez seulement si Claude échoue.
Faut-il en écrire un vous-même ?
Non. Écrire le vôtre est idéal pour des workflows uniques, mais si vous voulez juste le résultat, des skills prêts à l’emploi viennent avec leur SKILL.md déjà conçu et testé. Parcourez la bibliothèque KissMySkills de plus de 300 skills, packs de prompt et agents, ou la collection Claude Code skills. Vous voulez en voir un en action d’abord ? Essayez un générateur gratuit ou prenez une skill gratuite.
Questions fréquemment posées
SKILL.md est-il juste du Markdown ?
Oui — c’est un fichier Markdown standard avec un bloc frontmatter YAML en haut. Il s’ouvre dans n’importe quel éditeur de texte, aucun logiciel spécial requis.
Que faut-il dans un SKILL.md ?
Au minimum, un bloc frontmatter avec un nom et une description. Le corps avec les instructions rend la skill utile, mais les métadonnées la rendent découvrable et déclenchable.
Où placer le fichier SKILL.md ?
À la racine du dossier de la skill. Dans Claude Code, les skills se trouvent dans ~/.claude/skills/<name>/ pour un usage personnel ou .claude/skills/<name>/ dans un projet, avec le SKILL.md à la racine du dossier.
Puis-je utiliser le contenu d’un SKILL.md dans ChatGPT ou Gemini ?
Oui. Les instructions sont portables — collez le corps dans les instructions personnalisées de ChatGPT ou Gemini pour le même comportement. Le déclenchement automatique via frontmatter est une fonctionnalité Claude.
Commencez avec un exemple fonctionnel
Le moyen le plus rapide de comprendre SKILL.md est d’en lire un bon. Prenez une skill gratuite, ouvrez le fichier, et voyez la structure frontmatter-plus-étapes en action — puis lisez comment l’installer en trois minutes.