Générateur de compétences Claude (Skill)
Décrivez en langage naturel une tâche que vous répétez sans cesse et récupérez un SKILL.md complet, prêt à déposer dans Claude Code, avec le nom et la description vérifiés en direct par rapport aux vraies contraintes des Agent Skills pendant que vous tapez. Le générateur rédige la description selon la forme « ce qu'elle fait, puis quand l'utiliser », car c'est le seul champ que Claude lit pour décider si votre compétence s'applique à une demande. Il signale aussi en direct un brouillon qui semble couvrir plus d'une tâche sans rapport, car une compétence au périmètre étroit se déclenche bien plus fiablement qu'une compétence trop large.
1. Décrivez la tâche que vous répétez
Un langage simple convient. Plus le flux de travail est précis, plus la compétence générée sera pertinente.
Ou partez de l'un de ceux-ci
Votre SKILL.md apparaîtra ici, entièrement modifiable, avec le nom et la description vérifiés par rapport aux contraintes réelles d'Anthropic au fur et à mesure que vous tapez.
Ce qui se trouve vraiment dans un SKILL.md
Un skill est simplement un dossier contenant un SKILL.md : du frontmatter YAML en haut, des instructions markdown en dessous. Seuls deux champs de frontmatter sont obligatoires, et les deux ont des règles strictes que cet outil fait respecter pendant que vous tapez. name est limité à 64 caractères, n'autorise que des lettres minuscules, des chiffres et des tirets, et ne peut pas contenir les mots réservés « claude » ou « anthropic ». description doit être non vide et faire moins de 1024 caractères - c'est le seul champ qui mérite qu'on s'y attarde, car c'est le texte que Claude lit pour décider si votre skill est pertinent pour une demande donnée.
C'est pourquoi toute bonne description nomme deux choses : ce que le skill fait et quand il doit se déclencher. « Relit le diff d'une pull request » seul ne donne à Claude rien à quoi se raccrocher. « Relit le diff d'une pull request et signale les changements risqués. À utiliser quand l'utilisateur demande de relire une PR ou de vérifier un diff avant de merger » lui indique exactement quelles demandes relèvent de ce skill. Le générateur rédige les descriptions sur ce modèle, et signale la vôtre si la moitié « déclencheur » manque.
Sous le frontmatter, c'est du markdown ordinaire - un bref aperçu, une liste d'étapes sous ## Instructions, et des exemples là où ils ont leur place. Les skills plus volumineux peuvent aussi référencer des fichiers supplémentaires regroupés près de SKILL.md (un REFERENCE.md, un dossier scripts/ que Claude exécute via bash), afin que le détail le plus lourd ne soit chargé que lorsqu'il est réellement nécessaire.
Questions fréquentes
Qu'est-ce qu'une compétence (skill) Claude, exactement ?
Une compétence est un savoir-faire procédural que vous confiez une fois à Claude pour le réutiliser indéfiniment : un dossier contenant un fichier SKILL.md, composé d'un en-tête YAML (un nom et une description) suivi d'un corps d'instructions en markdown. Quand une demande correspond à la description, Claude charge ces instructions et les suit. C'est la différence entre retaper le même prompt de trois paragraphes chaque semaine et simplement taper une commande slash. Une compétence peut aussi référencer des fichiers supplémentaires à côté d'elle - un FORMS.md, un REFERENCE.md, ou des scripts dans un dossier scripts/ que Claude exécute via bash, où seule la sortie entre dans la conversation, pas le code du script.
Comment rédiger une description de compétence Claude qui se déclenche vraiment ?
Indiquez ce que fait la compétence puis quand Claude doit l'utiliser, dans cet ordre, en langage simple à la troisième personne. La description est la seule chose que Claude compare à la demande d'un utilisateur pour décider s'il doit exécuter votre compétence, donc une description vague signifie qu'elle restera inutilisée. Nommez les déclencheurs concrets que vous attendez - « À utiliser quand l'utilisateur demande de relire une PR, de vérifier un diff, ou demande ce qui semble risqué dans ces changements » - et restez sous la limite de 1024 caractères. Ce générateur de SKILL.md rédige la description selon cette forme quoi-plus-quand et vous avertit en direct si une modification supprime la partie déclencheur.
Une compétence est-elle la même chose qu'une commande slash personnalisée ?
Elles se recoupent. Claude Code a unifié les deux : un fichier de commande et une compétence donnent tous deux le même comportement /<nom> et acceptent le même en-tête, et prennent tous deux en charge le système de placeholders $ARGUMENTS. La différence est structurelle - une compétence est un dossier, elle peut donc contenir des fichiers d'accompagnement, des scripts et des références à divulgation progressive, et possède son propre champ name (un fichier de commande ignore name et paths, car son nom de fichier est le nom de la commande). Une commande est un seul fichier markdown, plus rapide à écrire quand la tâche tient en une courte instruction. Utilisez ce générateur de compétence personnalisée Claude Code quand le flux de travail comporte de vraies étapes, et le générateur de commande slash quand ce n'est pas le cas.
Dois-je vraiment diviser une grosse compétence en plusieurs plus petites ?
Dans la plupart des cas, oui - c'est l'erreur la plus fréquente en pratique avec les Agent Skills. Une compétence qui tente de couvrir plusieurs responsabilités sans rapport (par exemple gérer les commits, rédiger les descriptions de PR et mettre à jour un changelog, tout en un) se déclenche de façon peu fiable, car sa description doit couvrir vaguement les trois tâches à la fois, et Claude ne peut pas déterminer quelle partie s'applique à une demande donnée. Une analyse connue de 47 compétences communautaires populaires a montré que quarante d'entre elles rendaient en fait le résultat de Claude pire que sans compétence du tout, en grande partie pour cette raison. Ce générateur signale en direct un brouillon qui semble couvrir plus d'une tâche et recommande de le diviser.
Vous construisez plutôt quelque chose de court, en une ligne ? Le AI Slash Command Generator écrit la version fichier unique - même /command, avec moins d'échafaudage.