---
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.