Une skill est un dossier contenant un SKILL.md : un court en-tête YAML et des instructions en Markdown. Les instructions absorbent le temps, et la description décide si ces instructions sont jamais lues. Elle est confrontée à la tâche du moment, donc une description qui dit de quoi traite la skill sans jamais dire quand y recourir restera inutilisée indéfiniment — sans aucune erreur pour expliquer pourquoi. Ce créateur écrit le fichier et vérifie surtout ce champ : s'il nomme un déclencheur, s'il est assez long pour qu'une association ait lieu, et s'il gaspille ses premiers mots. Le nom est vérifié contre les règles de nommage des dossiers, et les instructions contre la longueur en dessous de laquelle elles ne changent rien.
Fonctionnalités
Nom vérifié contre les règles de dossier, avec une version corrigée proposée
Description vérifiée pour la clause déclenchante — ce qui provoque réellement l’association
Avertit quand une description est trop courte pour porter un signal
Liste d’outils autorisés facultative, choisie plutôt que saisie
Un score qui sépare les erreurs bloquantes des suggestions
Le chemin exact où le fichier doit se trouver
Frontmatter correctement quoté : un deux-points ne coupe pas la valeur
Se télécharge en SKILL.md, prêt à poser
Comment utiliser Générateur de skills
Nommez la skill en minuscules avec des tirets
Écrivez une description qui dise quoi et quand
Rédigez les instructions en Markdown
Lisez les constats puis téléchargez le SKILL.md
Exemple
Entrée
name: release-notes
Sortie
description: Writes release notes from a range of git commits. Use when the user asks for a changelog.
La clause « À utiliser quand… » transforme un sujet en déclencheur.
Erreurs courantes et dépannage
La skill ne semble jamais utilisée. — Presque toujours la description. Elle doit dire quand elle s’applique, avec les mots qu’une personne emploierait vraiment : types de fichiers, noms de tâche, tournures qu’elle taperait.
Le nom est refusé. — Il sert aussi de nom de dossier : minuscules, chiffres et tirets simples uniquement. Une version corrigée est proposée quand le vôtre ne convient pas.
Ma description contient un deux-points et le fichier casse. — Cela ne devrait pas : les valeurs sont quotées au besoin. Si vous modifiez le fichier à la main ensuite, quotez tout ce qui contient un deux-points suivi d’une espace.
La skill se charge mais ne change rien. — Des instructions très courtes déplacent rarement le comportement. Dites quoi produire, comment travailler et ce qu’il ne faut pas faire.
Foire aux questions
Qu’est-ce qui fait une bonne description de skill ?
Elle répond à deux questions en une ou deux phrases : ce que la skill fait et quand l’utiliser. C’est la seconde moitié qui est comparée : nommez les types de fichiers, la tâche et la façon dont on le formulerait. « Aide avec les documents » ne correspond à rien en particulier.
Où va le fichier ?
Dans un dossier portant le nom de la skill, à l’intérieur d’un répertoire de skills. Le chemin apparaît sous l’éditeur et se met à jour à la frappe. Le nom du dossier et celui du champ doivent concorder.
Faut-il définir une liste d’outils autorisés ?
Seulement si la skill a réellement besoin de moins d’outils que la session. La laisser vide fait hériter de ce qui est disponible, ce qui convient le plus souvent ; la restreindre garde concentrée une skill concentrée.
Quelle longueur pour les instructions ?
Assez pour être précises, pas plus. Quelques phrases changent rarement le comportement ; plusieurs pages finissent survolées. Des sections avec titres survivent mieux aux révisions qu’un long bloc.
Le fichier est-il validé ailleurs ?
Le chargeur accepte sans broncher un fichier à la description faible — c’est précisément le problème. Rien ensuite ne vous dit que la skill est inassociable, et c’est pourquoi la vérification se fait avant.
Outils associés
Linter de skills — Collez un SKILL.md et voyez ce qui empêche son association à une tâche.
Générateur de sous-agents — Créez le fichier de définition d'un sous-agent, outils et modèle compris.
Générateur de commandes — Créez une commande personnalisée, avec arguments et liste d'outils.