Skills Hermes Agent : composants clés et fonctionnement

Vous expliquez à votre agent, pour la cinquième fois cette semaine, comment créer une branche, ouvrir une pull request et vérifier que les tests automatiques passent. Il s'en sort très bien. Il aura tout oublié à la prochaine session. Les skills Hermes Agent existent pour que cette procédure ne s'écrive qu'une seule fois.

Un skill est un ensemble d'instructions réutilisables qui apprend à Hermes Agent comment mener une tâche précise, du développement au DevOps en passant par la recherche, les médias ou la productivité. Quatre composants le constituent : un fichier SKILL.md, un bloc de métadonnées en YAML, un dossier dédié et des fichiers de support.

Nous détaillons chacun de ces composants, la frontière entre les skills livrés avec Hermes et ceux qui s'installent à la demande, la manière dont un skill réclame une clé d'API sans jamais l'écrire en dur, et le choix du skill adapté à votre tâche.

Un skill, ce n'est pas un prompt de plus

Un prompt demande une action une fois. Un skill décrit une procédure que l'agent retrouve chaque fois que la même situation revient. La différence tient à la persistance de la connaissance, pas à la longueur du texte.

Le fichier SKILL.md dit à quoi sert le skill, quand l'utiliser, quelles étapes suivre et comment vérifier le résultat. Ce dernier point est celui qu'on oublie le plus. Sans critère de réussite, l'agent ne distingue pas une tâche terminée d'un échec passé inaperçu.

Un skill ne remplace ni le modèle ni les outils intégrés de Hermes. Il indique quel workflow suivre, quelles commandes shell lancer, quels fichiers d'appui sont disponibles et quelle configuration la tâche réclame. Si le fonctionnement général de l'agent vous échappe encore, commencez par la définition et le fonctionnement de Hermes Agent.

Les quatre composants d'un skill Hermes Agent

Le fichier SKILL.md

C'est le seul fichier obligatoire. Écrit en Markdown, un langage de mise en forme qui s'écrit en texte brut, il contient l'objectif du skill, ses instructions, ses notes de configuration et ses contraintes.

Un bon SKILL.md place le cas le plus fréquent en haut et repousse les situations rares vers le bas. L'agent trouve ainsi la marche à suivre habituelle immédiatement, sans perdre les détails utiles aux cas tordus.

Prenons un skill dédié aux pull requests GitHub. Il décrit la création de la branche, les modifications, l'ouverture de la pull request, la lecture des résultats des tests automatiques, puis la préparation de la relecture. Hermes rejoue ce déroulé à chaque demande du même type. Si ces étapes ne vous parlent pas encore, notre formation Git & GitHub couvre le vocabulaire des branches et des pull requests.

Le frontmatter YAML

Le frontmatter est le bloc de métadonnées placé tout en haut du fichier, entre deux lignes de trois tirets, au format YAML. Il donne à Hermes une carte d'identité du skill avant que les instructions ne commencent.

---
name: github-pr-workflow
description: Ouvrir une pull request, suivre les tests automatiques et preparer la relecture.
version: 1.0.0
author: votre-nom
license: MIT
platforms: [macos, linux]
required_environment_variables:
  - GITHUB_TOKEN
---

Les champs name, description, version, author et license rendent le skill lisible avant ouverture. La description est le texte sur lequel Hermes décide de charger ou non le skill, elle doit donc décrire une situation, pas vanter un produit.

D'autres champs conditionnent l'affichage. platforms réserve le skill à macOS, Linux ou Windows. Un skill peut aussi déclarer les outils dont il dépend, ou se présenter comme solution de repli quand l'outil principal manque.

Le dossier du skill

Chaque skill vit dans son propre dossier, avec ses ressources. Les skills livrés avec Hermes sont copiés dans ~/.hermes/skills/ pendant l'installation, souvent rangés par catégorie.

~/.hermes/skills/
└── devops/
    └── docker-management/
        ├── SKILL.md
        ├── references/
        ├── templates/
        └── scripts/

Cette structure unique rend les skills transportables. Instructions, scripts d'appui, documents de référence et exigences de configuration voyagent ensemble, au lieu d'être éparpillés entre plusieurs emplacements.

Les fichiers de support et les scripts

Trois sous-dossiers reviennent souvent :

• references/ pour la documentation longue et les tableaux que l'agent consulte à la demande
• templates/ pour les formats de sortie réutilisables
• scripts/ pour le code utilitaire

Les scripts servent quand une étape réclame un calcul exact : analyser un JSON, normaliser des colonnes, extraire des données. Réécrire cette logique dans le prompt à chaque exécution produit des résultats différents à chaque fois.

Hermes expose le chemin du dossier au chargement du skill, à travers la variable ${HERMES_SKILL_DIR}. Le SKILL.md peut donc pointer vers ${HERMES_SKILL_DIR}/scripts/parse.py sans chemin écrit en dur. Écrire ces petits utilitaires demande quelques bases, que couvre notre formation Python.

Skills livrés d'office et skills optionnels

Hermes distingue deux familles. Les bundled skills arrivent avec l'agent et couvrent les workflows dont beaucoup de monde a besoin : GitHub, recherche, prise de notes, productivité. Les optional skills attendent dans optional-skills/ jusqu'à ce que vous les installiez.

La commande hermes update resynchronise les skills livrés d'office. Elle respecte vos suppressions et vos modifications locales, donc un skill que vous avez retiré ne revient pas de lui-même. Pour restaurer un skill effacé par erreur, lancez hermes skills reset <nom> --restore.

Installer, configurer et retirer un skill optionnel

Les skills optionnels officiels portent un identifiant construit sur leur catégorie, du type official/blockchain/solana ou official/research/duckduckgo-search. Quatre étapes suffisent.

1. Repérez l'identifiant complet du skill voulu. Les skills livrés d'office n'ont besoin de rien, ils sont déjà dans ~/.hermes/skills/.
2. Lancez l'installation avec hermes skills install. Hermes télécharge le skill et l'ajoute à votre bibliothèque locale.
3. Renseignez la configuration réclamée : variables d'environnement, clés d'API, identifiants OAuth ou fichiers de compte de service, selon ce que déclarent les métadonnées.
4. Retirez-le quand il ne sert plus, sans toucher aux autres.

hermes skills install official/blockchain/solana
hermes skills uninstall solana

Une fois installé, le skill se comporte comme les autres. Hermes accède à son SKILL.md, à ses métadonnées, à ses scripts et à ses fichiers associés, exactement comme pour un skill livré d'office.

Clés d'API et identifiants : ce qu'un skill a le droit de demander

Les skills Hermes ne stockent aucun secret dans leur texte. Ils déclarent leurs besoins et laissent Hermes gérer les valeurs, à travers deux mécanismes distincts.

required_environment_variables couvre les secrets qui tiennent en une chaîne de caractères : clés d'API, jetons. Hermes demande la valeur à l'utilisateur au moment de la configuration, puis la transmet aux scripts sans l'exposer en clair au modèle.

required_credential_files couvre les secrets qui vivent dans un fichier : jetons OAuth, secrets clients, fichiers JSON de compte de service, certificats. Quand ces fichiers existent, Hermes les rend accessibles dans les environnements isolés, en local, dans Docker ou à distance.

Un script Python du skill lit alors la clé approuvée depuis os.environ. Vous ne resaisissez pas la même valeur pour chaque environnement d'exécution.

Quel skill pour quelle tâche

Le bon réflexe consiste à partir du travail que vous répétez déjà, puis à chercher la catégorie correspondante. Voici les correspondances les plus courantes.

Le format de fichier n'est pas propre à Hermes. Les Skills de Claude reposent sur la même idée d'un SKILL.md chargé quand la tâche correspond, ce qui rend l'apprentissage transférable d'un agent à l'autre.

Vos skills ne servent que si l'agent tourne

Un skill de veille hebdomadaire, un triage de tickets ou une alerte d'incident supposent tous que l'agent soit disponible au moment où le travail arrive. Un ordinateur portable en veille ne déclenche aucune tâche planifiée.

C'est pour cette raison que beaucoup d'utilisateurs installent Hermes sur un serveur privé virtuel plutôt que sur leur machine. L'agent garde alors sa mémoire, ses skills configurés et ses connexions de messagerie, indépendamment de votre poste de travail.

Avant d'en arriver là, testez chaque skill en local sur un petit exemple. Vérifiez la sortie, resserrez les instructions, puis seulement ensuite branchez-le sur du travail réel. Notre formation Hermes Agent déroule cette mise en place étape par étape.

Questions fréquentes

Non. Hermes copie ces skills dans ~/.hermes/skills/ pendant l'installation, ils sont donc disponibles sans commande supplémentaire. Seuls les skills optionnels, rangés dans optional-skills/, réclament un hermes skills install explicite.

Lancez hermes skills reset <nom> --restore. La commande hermes update ne suffit pas : elle resynchronise les skills livrés d'office tout en respectant vos suppressions locales, donc elle ne réinstalle pas ce que vous avez volontairement retiré.

Non. Un skill fournit un contexte de tâche réutilisable : quel workflow suivre, quels outils existants ou quelles commandes shell utiliser, quels fichiers de support consulter. Le modèle et les outils de base de Hermes restent inchangés.

Jamais dans le fichier SKILL.md. Une clé ou un jeton se déclare dans required_environment_variables, et Hermes en demande la valeur pendant la configuration sans l'exposer en clair au modèle. Les jetons OAuth, certificats et fichiers JSON de compte de service passent par required_credential_files.

Un seul suffit. Un SKILL.md qui décrit le déclencheur, les étapes et le critère de réussite constitue un skill valide. Les dossiers references/, templates/ et scripts/ s'ajoutent uniquement quand l'agent ne doit rien improviser.