Frontmatter

Le frontmatter est le bloc YAML délimité par --- en haut d'un fichier SKILL.md. Il sert de configuration pour la compétence, contrôlant ses métadonnées et son comportement d'exécution.

Les champs clés du frontmatter permettent un contrôle détaillé :

• name : Le nom d'affichage de la compétence. S'il est omis, le nom du répertoire de la compétence est utilisé.
• description : Un champ crucial expliquant ce que fait la compétence et son cas d'utilisation prévu. Si celui-ci est manquant, la compétence utilise le premier paragraphe du contenu markdown. Ce champ est essentiel pour l'invocation automatique.
• when_to_use : Fournit un contexte supplémentaire pour déclencher la compétence, ajouté à la description.
• argument-hint : Offre un indice affiché lors de l'autocomplétion, tel que [issue-number].
• arguments : Définit les arguments positionnels nommés qui peuvent être utilisés avec la substitution $name.
• disable-model-invocation : Le réglage sur true empêche Claude d'invoquer automatiquement la compétence.
• user-invocable : Réglé sur false pour masquer la compétence du menu de commande /. Notez que l'orthographe correcte est user-invocable avec un 'c'.
• allowed-tools : Spécifie les outils qui peuvent être utilisés sans permission explicite pendant que la compétence est active.
• disallowed-tools : Liste les outils qui sont retirés du pool disponible lorsque la compétence est active.
• model : Détermine quel modèle Claude utilise pendant que la compétence est active.
• effort : Catégorise la complexité de la compétence avec des niveaux tels que low, medium, high, xhigh, ou max.
• context : Le réglage sur fork exécute la compétence dans un contexte de sous-agent forké.
• agent : Spécifie le type de sous-agent à utiliser lorsque context est réglé sur fork.
• hooks : Permet de définir des hooks limités au cycle de vie de la compétence.
• paths : Utilise des motifs glob pour limiter quand la compétence s'active automatiquement.
• shell : Définit le shell à utiliser, soit bash soit powershell.

Bien que de nombreux champs offrent un contrôle granulaire, le champ description est particulièrement important pour permettre l'invocation automatique des compétences. Par exemple, la compétence Skill Creator utilise le frontmatter pour définir son nom, sa description et ses arguments, guidant les utilisateurs sur la façon de créer de nouvelles compétences.