Si vous expliquez à une IA les mêmes étapes, le même format et les mêmes mises en garde à chaque tâche, il est temps d'en faire un Skill. Un Skill est un dossier : un fichier SKILL.md précise quand l'utiliser et comment faire le travail, accompagné au besoin de scripts, de documents de référence et de modèles. En temps normal, l'IA ne voit que le nom et une ligne de description de chaque Skill, et ne lit le texte complet que si elle juge le Skill pertinent : on peut donc en installer des dizaines sans saturer la fenêtre de contexte.
Les trois parties de SKILL.md
La première partie est l'en-tête, dont les champs clés sont name et description. Le nom est un identifiant court ; la description explique en une ou deux phrases ce que fait le Skill et quand l'utiliser. La deuxième partie est le corps : les étapes réelles, ce qu'on fait d'abord, ensuite, le format de sortie et la gestion des cas particuliers. La troisième partie regroupe les fichiers annexes du même dossier — scripts de traitement, longues spécifications, modèles de sortie — le corps indiquant quand lire quel fichier.
La description décide si le Skill est appelé
Beaucoup de Skills bien écrits ne servent jamais, et la cause est presque toujours la description. L'IA s'appuie dessus pour décider si une demande relève de ce Skill : elle doit donc être aussi précise qu'une requête de recherche, en indiquant comment l'utilisateur formulerait la demande, quels fichiers sont traités et ce qui est produit. « Aide avec les documents » est trop vague. « Transforme la transcription d'une réunion en compte rendu avec actions à mener ; à utiliser quand l'utilisateur parle de compte rendu, de nettoyage d'enregistrement ou de résumé de réunion » est bien plus clair.
Des étapes dans le corps, pas des principes
Le corps est exécuté par l'IA, ce n'est pas un manuel pour humains. Utilisez des étapes numérotées, une action par étape. Écrivez les conditions : « si le fichier dépasse 100 lignes, le découper d'abord ». Un exemple complet d'entrée/sortie vaut mieux que trois paragraphes de principes. Pour tout ce qui doit être exact — conversion de format, calculs — écrivez un script et placez-le dans le dossier, pour que l'IA l'appelle au lieu de réécrire la logique à chaque fois.
Les 5 erreurs les plus fréquentes
Un : la description est trop générique, donc le Skill ne se déclenche pas quand il faut et se déclenche quand il ne faut pas. Deux : tout entasser dans SKILL.md. Un corps de plusieurs milliers de mots doit être lu à chaque fois, ce qui ralentit et fait manquer l'essentiel ; les documents longs vont en annexe. Trois : énoncer des principes sans exemples. La notion de « concis et professionnel » de l'IA n'est pas la vôtre. Quatre : ne pas tester. Plutôt que de livrer dès l'écriture, préparez quelques demandes réelles et vérifiez que le Skill est bien appelé et que la sortie tient. Cinq : mettre des clés d'API ou des identifiants dans le Skill. Les Skills circulent et se copient : les informations sensibles vont dans des variables d'environnement.
Du Skill personnel au pack d'entreprise
Un Skill pour soi doit simplement fonctionner. Pour le partager dans une équipe ou une entreprise, il faut aussi penser versionnage, revue de sécurité, évaluation de la qualité et diffusion centralisée. C'est l'écart entre « un Skill qui marche bien » et « un pack de compétences d'entreprise ».
Illustrated Skill (cours en chinois, 56 leçons illustrées) part du principe du Skill et vous amène, schéma après schéma, à un pack testé, audité et publiable sur un SkillHub d'entreprise ; les 6 premières leçons sont gratuites.