🎯 ObjectifIdentifier les 2 parties · Comprendre le frontmatter YAML · Lire les instructions Markdown · Comprendre le chargement progressif

Structure d'un Skill

FichierObligatoire ?Rôle
SKILL.mdOuiCœur du Skill : instructions + métadonnées
scripts/NonScripts Python/JS exécutables
references/NonDocuments de référence consultables
assets/NonFichiers de sortie (templates, logos...)
📌 À retenirPour 90% des Skills, un SKILL.md seul suffit. Commencez simple.

Le Frontmatter YAML — La carte d'identité

---
name: compte-rendu-formation
description: Crée des CRs selon le modèle interne.
  Utilise ce Skill quand l'utilisateur demande
  un compte-rendu, un CR ou un résumé de séance.
---

name : identifiant unique, 64 car. max, tirets uniquement, minuscules

description : CRITIQUE — Claude l'utilise pour décider si le Skill est pertinent

⚠️ La description est la cléUne description vague = Skill qui ne se déclenche pas. Soyez précis et listez les mots-clés déclencheurs.

Les 3 niveaux de chargement

NiveauQuand ?Coût
1 — MétadonnéesToujours, au démarrage~100 tokens par Skill
2 — InstructionsQuand le Skill est déclenché< 5 000 tokens
3 — RessourcesUniquement si nécessaireVariable, à la demande
💡 MéthodeDépliez chaque étape pour analyser le SKILL.md exemple, partie par partie.
1
Les délimiteurs --- (frontmatter)
▶

Tout SKILL.md commence par trois tirets --- et se termine par trois autres tirets ---. Tout ce qui est entre ces deux lignes est le frontmatter YAML — les métadonnées du Skill.

2
Le champ name
▶

Format : name: mon-skill-nom
Règles : minuscules, tirets uniquement, 64 caractères max, pas d'espaces ni d'accents.
Ce nom devient aussi la commande /mon-skill-nom si vous voulez l'invoquer manuellement.

3
Le champ description
▶

La description dit à Claude quand utiliser ce Skill. Elle doit :
• Expliquer ce que fait le Skill
• Lister les types de demandes qui doivent le déclencher
• Inclure des synonymes et formulations alternatives
Longueur recommandée : 2-4 phrases.

4
Le corps Markdown — les instructions
▶

Après le second ---, tout le reste est du Markdown libre. Vous utilisez :
• # Titre pour organiser les sections
• 1. 2. 3. pour les procédures ordonnées
• - pour les règles et contraintes
• **texte** pour mettre en évidence les points critiques

5
Les sections recommandées
▶

Un bon corps de SKILL.md contient :
1. Contexte : qui utilise ce Skill et pourquoi
2. Structure attendue : format du résultat
3. Style et ton : comment s'exprimer
4. Règles : contraintes à respecter
5. Ce que Claude NE doit PAS faire : les interdits
6. Exemple : un résultat type (souvent la partie la plus utile)

Question 1 / 4
Le frontmatter YAML dans un SKILL.md sert à...
Écrire les instructions pour Claude
Fournir les métadonnées (nom, description) qui aident Claude à décider d'utiliser le Skill
Définir la mise en page du fichier
Le frontmatter YAML = la carte d'identité du Skill. Il contient le name et la description — les deux informations que Claude lit pour décider si le Skill est pertinent.
Question 2 / 4
Quel champ est le plus critique pour que votre Skill se déclenche correctement ?
Le champ name
Le champ description
La longueur des instructions
La description est ce que Claude lit pour décider si votre Skill est pertinent. Une description vague = Skill qui ne se déclenche pas. C'est le champ le plus important à soigner.
Question 3 / 4
Quel est le coût en tokens quand 15 Skills sont installés mais aucun n'est déclenché ?
Énorme — tous les SKILL.md sont chargés en permanence
Faible — seulement ~100 tokens par Skill (nom + description)
Nul — les Skills ne consomment aucun token
Grâce au chargement progressif, seules les métadonnées (nom + description) sont en mémoire en permanence. ~100 tokens × 15 Skills = 1500 tokens, soit très peu. Le contenu complet ne charge que si c'est pertinent.
Question 4 / 4
Quel fichier est absolument obligatoire dans un dossier Skill ?
scripts/main.py
README.md
SKILL.md
Seul SKILL.md est obligatoire. Les dossiers scripts/, references/ et assets/ sont optionnels et ne sont utiles que pour les Skills avancés.

0 / 10 acquis

🧬 Je comprends la structure

Je sais ce qu'est un frontmatter YAML et comment le délimiter (---)
Je connais la règle de nommage du champ name (minuscules, tirets)
Je comprends pourquoi la description est le champ le plus important
Je sais ce que contient le corps Markdown d'un SKILL.md

⚡ Je comprends le chargement

Je comprends les 3 niveaux de chargement progressif
Je sais que 15 Skills installés n'impactent pas les performances
Je sais que seul SKILL.md est obligatoire

📖 Je peux lire un SKILL.md

J'ai lu l'exemple de SKILL.md complet du Session 3
Je serais capable d'identifier le frontmatter et le corps dans un nouveau SKILL.md
J'ai fait le quiz et obtenu 3/4 ou plus
🎯 Session 4Créer votre premier Skill par conversation avec le skill-creator intégré. SKILL.md généré en 20 minutes.