Shamalo example
rediger-un-skill
Shamalo example: writing a SKILL.md (name, an actionable description, progressive disclosure).
MIT
Rédiger un skill
Exemple Shamalo. Le format est le produit.
Frontmatter (chargé pour toutes les skills)
name: 1–64,[a-z0-9-]+, identique au dossier, pas de--.description: 1–1024. Dire quoi et quand. Les mots-clés d’activation vont ici, pas dans le corps.license: court (MIT,Apache-2.0, ou un fichier bundled).
Corps (chargé seulement à l’activation)
Rester sous ~500 lignes. Sortir les références dans references/, les scripts dans scripts/. C’est la divulgation progressive : métadonnées → instructions → fichiers à la demande.
Pièges
- Description vague (« aide avec les PDF ») : l’agent ne saura pas l’activer.
- Copier un skill Cursor/Anthropic sans licence claire.
paths/icon/color: extensions Cursor, pas la spec. Le validateur les signale, il ne les refuse pas.
--- name: rediger-un-skill description: Rédige un SKILL.md conforme à agentskills.io — name, description activable, divulgation progressive. À utiliser pour créer ou revoir une skill, pas pour un prompt jetable. license: MIT metadata: author: shamalo origin: teaching-example --- # Rédiger un skill Exemple Shamalo. Le format est le produit. ## Frontmatter (chargé pour toutes les skills) - `name` : 1–64, `[a-z0-9-]+`, identique au dossier, pas de `--`. - `description` : 1–1024. Dire **quoi** et **quand**. Les mots-clés d’activation vont ici, pas dans le corps. - `license` : court (`MIT`, `Apache-2.0`, ou un fichier bundled). ## Corps (chargé seulement à l’activation) Rester sous ~500 lignes. Sortir les références dans `references/`, les scripts dans `scripts/`. C’est la divulgation progressive : métadonnées → instructions → fichiers à la demande. ## Pièges - Description vague (« aide avec les PDF ») : l’agent ne saura pas l’activer. - Copier un skill Cursor/Anthropic sans licence claire. - `paths` / `icon` / `color` : extensions Cursor, pas la spec. Le validateur les signale, il ne les refuse pas.