Write a Skill (Claude Code skill)
Skill pour créer des skills. /write-a-skill te guide pour produire un SKILL.md propre avec progressive disclosure (instruction principale courte + REFERENCE.md/EXAMPLES.md séparés au-delà de 100 lignes), description optimisée pour le routage agent (max 1024 char, 3e personne, format « what + Use when »), et utility scripts uniquement quand l'opération est déterministe. Insiste sur la règle dure : la description est la SEULE chose que ton agent voit pour décider quelle skill charger, elle doit donc lister les triggers explicites.
Forces
- Force la discipline description (triggers explicites), résout le bug n°1 des skills custom
- Pattern progressive disclosure clair : SKILL.md sous 100 lignes + fichiers REFERENCE/EXAMPLES séparés
- Critère explicite « add scripts when operation is deterministic », anti-bloat
- Checklist review fournie, vérifies triggers, taille, exemples, terminologie cohérente
Limites
- Pas de scaffolding automatisé : crée un SKILL.md mais pas l'arborescence skill-name/scripts/ complète
- Recommandations « 100 lignes max » parfois trop strictes pour skills techniques denses
- Outil simple, pas une alternative à skill-creator officiel d'Anthropic pour skills production
Pour qui
- Devs qui découvrent les skills Claude Code et veulent éviter les pièges du débutant (description floue, fichier monolithique)
- Équipes qui maintiennent un repo de skills internes et veulent un format unifié
- Formateurs qui veulent transmettre les bonnes pratiques skill rapidement