SKILL.md

Définition

SKILL.md est le manifeste d’une skill au sens agentskills.io. Le frontmatter exige un name (1–64, [a-z0-9-]+, pas de doubles tirets) et une description (1–1024) assez précise pour que l’agent sache quand charger le corps. Licence, compatibilité, metadata, allowed-tools sont optionnels. Le corps est la procédure.

Les champs Cursor (paths, icon, color…) sont des extensions. Un validateur honnête les accepte avec une note, et refuse un name hors spec même si l’icône est jolie.

Quand ça compte

À chaque skill créée, forkee, ou revue en PR. C’est le fichier que la bibliothèque Shamalo affiche et que le validateur parse (js-yaml, pas un regex). Si la licence n’autorise pas la copie, on n’en vendore pas le corps — carte + URL.

C’est aussi le support d’enseignement : une skill custom Shamalo montre le format, elle ne se prétend pas officielle.

Pièges

YAML indenté à l’œil jusqu’à ce que le parseur avale un mapping mal fermé. Description roman. Name en majuscules ou avec des espaces. Mettre des secrets dans le body. Copier une skill dont LICENSE.txt dit non.

Termes liés

• Agent Skills
• Progressive disclosure
• Budget de contexte

Outil associé

Coller un frontmatter et son corps : champs requis, longueurs, description activable : Ouvrir validateur SKILL.md.