Le YAML frontmatter est la partie la plus importante. C’est lui qui décide si Claude charge ton skill.

Format minimal requis :

---
name: ton-skill-name
description: Ce que ça fait. Utiliser quand l'utilisateur demande [phrases spécifiques].
---

Tous les champs optionnels :

---
name: ton-skill
description: [description obligatoire]
license: MIT
allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch"
metadata:
  author: Nom Entreprise
  version: 1.0.0
  mcp-server: nom-serveur
  category: productivity
  tags: [project-management, automation]
  documentation: https://exemple.com/docs
---

Règles du champ description (critique) :

• Doit inclure les deux : ce que ça fait + quand l’utiliser (conditions de déclenchement)
• Maximum 1024 caractères
• Pas de balises XML (< ou >)
• Inclure des phrases spécifiques que les utilisateurs diraient
• Mentionner les types de fichiers si pertinent

Descriptions correctes vs incorrectes :

✅ Bon :

Analyse les fichiers design Figma et génère la documentation de handoff développeur.
Utiliser quand l'utilisateur uploade des fichiers .fig, demande des "specs design",
"documentation composants", ou "handoff design-to-code".

❌ Trop vague : Aide avec les projets. ❌ Triggers manquants : Crée des systèmes de documentation multi-pages sophistiqués. ❌ Trop technique : Implémente le modèle d'entité Project avec des relations hiérarchiques.

Restrictions de sécurité :

• Interdiction d’angles XML () dans le frontmatter — le frontmatter apparaît dans le system prompt
• Interdiction d’utiliser « claude » ou « anthropic » dans le nom (réservés)