Module 2 · Écrire un SKILL.md qui se déclencheEnviron 1 min
L'en-tête : deux champs obligatoires
Tout SKILL.md commence par un en-tête YAML encadré par deux lignes ---. Deux champs sont obligatoires, name et description. Voici celui de la Skill de Sofia :
markdown
---
name: compte-rendu-client
description: Rédige les comptes rendus de réunion client de l'agence au format maison (décisions, actions avec responsable et échéance, points ouverts), en français et au vouvoiement. À utiliser dès qu'on demande un compte rendu, un CR, une synthèse ou un récapitulatif de réunion, d'appel ou de visite client, même à partir de notes brutes.
---Les règles du standard
name: 64 caractères au plus, minuscules, chiffres et tirets seulement, sans tiret au début, à la fin ni doublé. Il reprend exactement le nom du dossier.namene peut pas contenir les mots réservésclaudeetanthropic.description: obligatoire, non vide, 1 024 caractères au plus.- Ni l’un ni l’autre ne peut contenir de balise XML.
Le standard prévoit aussi des champs facultatifs : license, compatibility (500 caractères au plus, pour signaler un besoin d’environnement), metadata (des paires clé et valeur, comme l’auteur ou la version) et allowed-tools, encore expérimental. La plupart des Skills s’en passent.
Un en-tête cassé ne fait pas de bruitSi le YAML est mal formé (délimiteur oublié, guillemet non fermé), Claude Code charge quand même le corps, mais sans description : Claude ne peut plus déclencher la Skill de lui-même. Quand une Skill reste muette, vérifiez l’en-tête en premier.