Créer votre propre skill

Ce que c'est

Le squelette d'un skill Claude Code, réduit à ce qui est obligatoire, à copier pour démarrer le vôtre.

Un skill tient en très peu de chose : un fichier SKILL.md, un en-tête avec deux champs, name et description, puis vos instructions en markdown. C'est tout ce que le format exige. Vous pouvez ajouter à côté un dossier scripts/ pour du code exécutable, references/ pour de la documentation que Claude consulte, et assets/ pour des fichiers à copier dans le projet.

Quand le sortir

Dès la troisième fois que vous réexpliquez la même chose à Claude. Un skill, c'est exactement ça : une explication que vous n'aurez plus à refaire.

Les bons candidats sont vos procédures à vous. La façon dont vous nommez vos branches, les étapes de votre mise en production, le format de vos comptes rendus client. Personne d'autre ne les écrira, et ce sont celles qui vous font perdre le plus de temps à répéter.

Comment s'en servir

Copiez le dossier sous ~/.claude/skills/<votre-nom>/, remplacez les deux champs de l'en-tête, écrivez vos instructions dessous.

Tout se joue sur la description, et c'est le seul endroit où on se trompe. Elle ne décrit pas ce que le skill fait, elle dit quand Claude doit le sortir. C'est ce texte qu'il lit pour décider, et rien d'autre.

Comparez : « outils de déploiement » ne déclenchera jamais rien, personne ne formule sa demande comme ça. « À utiliser quand l'utilisateur veut mettre en ligne, déployer, publier une version ou parle de production » se déclenche, parce que les mots sont ceux que vous employez vraiment.

Écrivez donc la description en dernier, une fois les instructions rédigées, et mettez-y les formulations que vous utilisez en vrai plutôt que le vocabulaire propre du domaine.

Ce que contient l'archive

1 outil, prêt à déposer dans votre projet :

• template-skill