Skills Claude Code : industrialiser ses procédures répétées

Si vous vous surprenez à recoller les mêmes instructions à chaque session — la procédure de déploiement, la checklist de revue, vos conventions d'API — c'est le signe qu'il vous faut une skill.

Une skill, c'est quoi

Une skill est un fichier SKILL.md (Markdown + frontmatter YAML) qui encapsule une procédure réutilisable. Elle se charge à la demande : vous tapez /nom, ou Claude la détecte comme pertinente. L'intérêt clé, c'est la progressive disclosure — une skill de 500 lignes ne coûte presque aucun contexte tant qu'elle n'est pas invoquée.

La structure

Une skill projet vit dans .claude/skills/<nom>/SKILL.md (versionnée), une skill perso dans ~/.claude/skills/<nom>/SKILL.md. Le dossier peut contenir scripts et ressources que la skill importe via @.

---
name: deploy
description: Déploie en production en suivant la checklist. À utiliser pour toute mise en prod.
disable-model-invocation: true
---

## Déploiement production

1. Tests verts, lint et types OK
2. Changelog à jour
3. bun run build
4. git tag -a v1.x.x -m "Release" puis git push --tags

Skill ou sous-agent ?

C'est la confusion la plus fréquente. Une skill se charge dans votre conversation principale : c'est de la connaissance réutilisable, là où vous êtes. Un sous-agent s'isole dans un contexte frais : c'est de la délégation. Une checklist de déploiement est une skill ; un relecteur de code qui travaille à part est un sous-agent.

Bonnes pratiques

• Description précise : trop vague, Claude l'auto-invoque à tort. « Valide la sécurité d'une route API après l'avoir créée » bat « skill de dev générale ».
• Gardez scripts et templates à côté du SKILL.md et importez-les via @ plutôt que de tout inliner.
• Versionnez les skills projet : toute l'équipe partage la même procédure, pas une variante par tête.
• Passez les actions sensibles en disable-model-invocation: true pour que Claude ne puisse pas les déclencher tout seul.

Une règle CLAUDE.md, on l'écrit une fois et elle s'applique partout. Une skill, on l'invoque quand on en a besoin. L'une est un fond permanent, l'autre un outil qu'on sort du tiroir.