Tu demandes souvent la même chose à Hermes : alléger un texte, conserver les faits, éviter les ajouts. À chaque fois, tu réécris les mêmes précautions. Une skill permet de garder cette méthode dans un document qu’Hermes peut charger pour un nouveau travail.
Nous allons en créer une toute petite : relire un texte court, proposer une version plus fluide et vérifier que son sens reste intact. Tu suivras le trajet jusqu’à un second essai, sans installer de paquet ni écrire de script.
Hermes doit déjà répondre avec un modèle capable d’appeler ses outils. Le parcours utilise son interface de conversation dans un terminal Linux ou WSL. Les commandes ciblent le profil default ; remplace ce nom partout si tu travailles dans un autre profil.
Il faut pouvoir utiliser skill_manage pour enregistrer la skill et skill_view pour relire ses instructions. Ce sont des outils appelés par Hermes, pas des commandes du terminal. Les textes et réponses ci-dessous sont fictifs ; ce parcours n’est pas le compte rendu d’un essai exécuté.
1. Essayer une première relecture
Dans ton terminal, ouvre une conversation avec les outils de skills :
hermes -p default chat --toolsets skills
Dans Hermes, saisis /tools et cherche skill_manage et skill_view dans le catalogue actif. Si l’un manque, vérifie la sélection de ton profil avec le tuto des premiers outils avant de poursuivre.
Pour commencer, demande une simple relecture :
Relis ce texte court. Signale au maximum deux lourdeurs, puis propose une version plus fluide. Garde les faits, les réserves et le ton. N’ajoute aucune information. Ne crée pas de skill pour le moment.
Texte : « La maquette Silex est maintenant terminée et nous avons fini de la terminer. La prochaine étape sera de relire la page de présentation. La date de publication n’est pas encore fixée. »
Tu dois retrouver trois faits : la maquette est terminée, la page reste à relire et la date n’est pas fixée. Une reformulation qui annonce une publication prochaine ajoute quelque chose que le texte ne dit pas.
Si la réponse ne convient pas, fais corriger le point concerné avant de continuer. Une skill ne rendra pas automatiquement bonne une méthode encore mal définie.
2. Séparer la méthode du texte
Ce que tu veux réutiliser, ce sont les règles : relever quelques lourdeurs, proposer une version, garder les faits et leurs réserves. Le nom Silex et l’avancement de sa maquette appartiennent uniquement à cet essai.
La skill contiendra la façon de relire, tandis que chaque nouvelle demande apportera le texte à relire. Elle ne réentraîne pas le modèle ; ses instructions viennent guider la conversation lorsqu’elles sont chargées.
Même méthode, nouveau texte
Tu conserves les règles, pas le texte de chaque essai.
Notre première skill sera un simple document. D’autres peuvent inclure des références ou des scripts, mais ce n’est pas nécessaire ici. Elle ne donne pas non plus de nouveaux droits d’accès : une méthode peut demander un outil sans le rendre disponible.
3. Préparer des instructions courtes
Le fichier principal d’une skill s’appelle SKILL.md. C’est un fichier texte avec un petit en-tête — notamment son nom et sa description — puis la méthode à suivre.
Demande d’abord une proposition, sans écriture :
Prépare une skill nommée relecture-courte-atelier, sans l’enregistrer pour le moment.
Elle servira à relire un texte court fourni dans la demande. Garde ces règles : relever au maximum deux lourdeurs utiles à corriger ; proposer une reformulation ; conserver les faits, les négations, les réserves et le ton ; ne rien inventer. Si une ambiguïté empêche une reformulation fidèle, poser une question au lieu de trancher. Si le texte manque, le demander.
Le résultat doit avoir deux parties : « Points à améliorer » et « Proposition ». Ne conserve ni le texte Silex ni sa réponse. Aucun script, aucune dépendance et aucune modification de fichier pendant une relecture.
Montre le contenu complet du SKILL.md proposé. Vérifie que ce nom n’existe pas déjà et indique le profil et la destination prévus. Si tu ne peux pas les déterminer, signale ce qui manque. N’écris rien à cette étape.
Relis le brouillon comme une petite recette. Pourrait-il guider une relecture sans connaître notre premier échange ? Contient-il les deux parties attendues ? A-t-il gardé les réserves aussi bien que les faits ?
Un en-tête pourrait ressembler à ceci ; c’est un repère de lecture, pas le fichier complet à enregistrer :
---
name: relecture-courte-atelier
description: Relire un texte court sans changer ses faits ni son ton.
---
La destination dépend du profil et peut être personnalisée. Ne déduis pas le chemin d’un exemple trouvé en ligne. Si le nom existe déjà, choisis un nom neuf et remplace-le dans toutes les consignes suivantes ; ne remplace pas une skill existante pour cet exercice.
4. Enregistrer la version que tu as relue
Une fois le contenu, le nom et la destination compris, demande cette création précise :
Observe le retour de l’outil. Un refus doit être compris, pas contourné. Si l’écriture est appliquée, conserve le chemin indiqué et passe à la relecture.
Si le retour indique staged, la création attend une approbation : la skill n’est pas encore enregistrée à sa destination définitive. Dans la conversation Hermes, /skills pending liste les demandes. Utilise ensuite /skills diff IDENTIFIANT pour consulter la bonne modification, puis /skills approve IDENTIFIANT pour l’appliquer si elle correspond au contenu accepté. Remplace IDENTIFIANT par la référence exacte affichée ; ne saisis pas ce mot littéralement. Pour la refuser, utilise /skills reject IDENTIFIANT.
Ce cas dépend du réglage skills.write_approval. Ne le désactive pas pour aller plus vite. Si ta version ne reconnaît pas ces commandes, consulte son aide avant de poursuivre.
5. Relire la skill enregistrée
Il reste à vérifier ce qu’Hermes pourra réellement charger :
Regarde l’appel à skill_view et son retour, pas seulement le commentaire final. Les instructions chargées doivent correspondre à la version acceptée. Si elles diffèrent, ou si Hermes charge une autre copie portant le même nom, règle ce point avant de tester la relecture.
Tu peux demander une correction ciblée avec skill_manage, puis relire à nouveau. Ne recrée pas plusieurs skills presque identiques pour compenser une première version mal comprise.
6. Réutiliser la méthode sur un nouveau texte
Quitte avec /quit, puis ouvre une nouvelle conversation dans le même profil avec la commande de l’étape 1. Cela évite de reprendre tout le premier échange comme contexte de travail.
Demande explicitement le chargement, puis fournis uniquement le nouveau texte et la tâche :
Charge relecture-courte-atelier avec skill_view, puis utilise ses instructions pour relire le texte ci-dessous. Si la skill ne peut pas être chargée, signale-le avant de poursuivre.
Texte : « Le formulaire du projet Nacre est prêt et sa préparation est terminée. Le test sur téléphone reste à faire. Nous n’avons pas encore décidé de la date d’ouverture. »
Vérifie d’abord l’appel de chargement. Une skill enregistrée peut être disponible sans avoir été utilisée ; une réponse qui ressemble au format demandé ne prouve pas à elle seule ce chargement.
Voici une proposition illustrative parmi d’autres :
Points à améliorer
« Est prêt » et « sa préparation est terminée » répètent la même information.
Proposition
Le formulaire du projet Nacre est prêt. Le test sur téléphone reste à faire. La date d’ouverture n’est pas encore décidée.
Compare avec le texte fourni : le formulaire est prêt, le test reste à faire et la date est indécise. La skill doit aider à garder ces nuances, pas les effacer pour rendre la phrase plus affirmative.
Quand garder cette skill ou l’améliorer
Essaie-la ensuite sur quelques textes courts que tu peux relire toi-même. Note une correction récurrente plutôt que d’ajouter une règle à chaque détail de style. Si elle omet souvent une réserve, améliore cette instruction et refais un essai. Si elle ne t’apporte rien, tu peux simplement cesser de l’invoquer.
| Ce que tu observes | La suite utile |
|---|---|
| La skill n’est pas chargée | Vérifier son nom, le profil et le retour de chargement. |
| Une règle manque dans le fichier | Corriger la méthode, puis relire la version enregistrée. |
| Les règles sont présentes mais la réponse déforme le texte | Corriger la réponse et essayer un autre cas avant de conclure. |
| La relecture te fait gagner du temps | Conserver la méthode et continuer à contrôler les faits. |
Une skill sert à retrouver une méthode. Un outil donne une capacité d’action ; MCP permet de brancher des outils exposés par un serveur. Tu peux donc utiliser notre skill de relecture sans serveur MCP ni recherche web.
Quand tu voudras partir d’une méthode que tu as construite au fil d’un vrai travail, poursuis avec le compagnon Transformer une méthode de travail en skill. Il approfondit ce qu’il faut conserver et ce qu’il faut redemander à chaque nouveau cas.
Sources et repères de version
Parcours recoupé avec la documentation officielle des skills, ainsi que le code de skill_manage et de skill_view. Les commandes et l’affichage peuvent varier selon ta version. Aucun scénario Hermes n’a été exécuté pour cette révision.