Skills Hermes Agent : installer et créer votre propre skill

Un skill est une instruction enregistrée pour un agent : vous décrivez une fois comment effectuer une tâche, et Hermes l’applique ensuite lorsque vous appelez /skill-name, sans qu’il soit nécessaire de répéter vos explications. Vous pouvez installer un skill prêt à l’emploi avec une seule commande et créer le vôtre de deux façons : écrire manuellement le fichier SKILL.md ou utiliser /learn.

Si vous n’avez pas encore installé Hermes, commencez par le guide ce qu’est cet agent et comment l’installer, puis passez aux skills.

Qu’est-ce qu’un skill dans Hermes Agent ?#

Vous écrivez une instruction dans un message destiné à l’agent. Un skill est stocké dans un fichier séparé, et Hermes peut utiliser cette instruction pour de futures tâches. L’agent dispose d’une liste de noms et de descriptions, et charge le texte complet du skill lorsqu’il est pertinent pour la tâche. Cela économise de l’espace dans le contexte : toutes les instructions ne sont pas chargées en même temps.

Un skill ne donne pas, à lui seul, de nouveaux outils ou accès à l’agent ; il décrit comment utiliser les outils dont celui-ci dispose déjà. Une nouvelle intégration avec un service externe passe par MCP, un sujet distinct. Si une tâche nécessite une logique de programme précise, une autorisation spéciale ou le traitement d’un flux d’événements, elle a besoin d’outils d’agent ; un skill seul ne suffit pas.

Pour une tâche courante, choisissez un skill prêt à l’emploi si ses instructions conviennent et si sa source a été vérifiée. Écrivez le vôtre si vous devez conserver votre séquence d’actions particulière, vos contraintes et votre format de sortie. Utilisez /learn si vous avez déjà du matériel ou si vous avez terminé un processus et ne souhaitez pas écrire le fichier manuellement.

Le format est ouvert et compatible avec la spécification Agent Skills ; les skills d’autres catalogues fonctionnent donc généralement dans Hermes sans modification de format, même si un skill particulier peut nécessiter ses propres outils ou clés. Vous pouvez aussi partager votre skill si vous le souhaitez.

Quels skills sont déjà installés et où sont-ils stockés ?#

Le dossier est organisé ainsi :

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

SKILL.md est le seul fichier obligatoire. Tout le reste s’ajoute selon les besoins : references/ pour les documents plus longs, scripts/ pour les programmes auxiliaires, et templates/ et assets/ pour les modèles et les fichiers.

Le catalogue intégré comprend des skills pour les tâches quotidiennes : trouver des GIF, travailler avec des PDF, des feuilles de calcul, YouTube, GitHub et des notes. La liste complète avec les descriptions figure sur la page du catalogue des skills intégrés. À chaque hermes update, Hermes met également à jour les skills intégrés tout en préservant vos modifications.

Comment installer un skill prêt à l’emploi depuis le catalogue ?#

1. Rechercher dans le catalogue

   hermes skills search pdf
   

   La recherche couvre toutes les sources connectées. Pour afficher le catalogue complet sans filtre, exécutez hermes skills browse.

2. Consulter la fiche du skill

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   La fiche indique la description, la source et le niveau de confiance. N’installez pas le skill de quelqu’un d’autre sans avoir lu sa fiche.

3. L’installer

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Hermes télécharge SKILL.md et les fichiers associés, effectue un contrôle de sécurité et place le tout dans ~/.hermes/skills/. Le skill est immédiatement disponible sous la forme de la commande /pdf. Si le skill nécessite des outils ou des clés supplémentaires, ils sont indiqués dans son fichier SKILL.md et Hermes vous le signalera pendant l’installation.

Le contrôle de sécurité recherche les tentatives d’envoi de données vers l’extérieur, les instructions injectées à destination de l’agent et les commandes susceptibles de supprimer ou d’endommager des fichiers. Les sources ont différents niveaux de confiance :

Si le contrôle émet un avertissement, vous pouvez poursuivre l’installation avec l’option --force, mais lisez d’abord le risque détecté. Un verdict « dangereux » ne peut pas être contourné. Le contrôle ne garantit pas, à lui seul, la sécurité : avant d’exécuter pour la première fois le skill de quelqu’un d’autre, lisez ses instructions et les commandes associées.

Comment installer un skill depuis GitHub ou un lien ?#

Trois façons de l’installer :

# 1. Un skill précis depuis un dépôt GitHub (son chemin dans le dépôt suit son nom)
hermes skills install anthropics/skills/skills/pdf

# 2. Un lien direct vers un fichier SKILL.md sur n’importe quel site (partagez ce skill dans une conversation)
hermes skills install '<OFFICIAL_URL>'

# 3. Connecter un dépôt entier comme source (remplacez par votre propriétaire et votre dépôt)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Avec un lien direct, Hermes télécharge SKILL.md et uniquement les fichiers provenant des sous-dossiers du service qui y sont mentionnés ; il ne télécharge pas les fichiers du site qui ne sont pas concernés. Le lien est mémorisé comme source, et hermes skills update mettra ensuite le skill à jour depuis cette même adresse.

Outre GitHub, des catalogues de skills externes peuvent être connectés. Vous pouvez y trouver des skills avec la même commande hermes skills search, en indiquant la source.

Comment utiliser un skill après son installation ?#

Saisissez les commandes hermes ... dans le terminal et les appels /skill-name dans une conversation avec l’agent (dans le même terminal, l’interface web ou une messagerie) :

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Si vous saisissez /skill-name sans tâche, Hermes chargera les instructions et vous demandera ce qu’il doit faire. Vous pouvez appeler plusieurs skills sur une même ligne, jusqu’à cinq ; le texte restant devient la tâche :

/github-pr-workflow /test-driven-development close issue 123 and open a PR

Pour les combinaisons que vous utilisez régulièrement, il existe des groupes de skills, appelés « bundles » dans la terminologie de Hermes : hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development regroupe plusieurs skills sous une commande courte /backend-dev. Un tel bundle sert d’alias ; les skills qu’il contient doivent avoir été installés au préalable.

Les commandes slash fonctionnent aussi dans Telegram si la passerelle est connectée ; la configuration est présentée dans le guide comment connecter Hermes Agent à Telegram. C’est également un moyen pratique d’exécuter des skills depuis votre téléphone.

Comment créer votre propre skill : que mettre dans SKILL.md ?#

Vous pouvez copier ce skill et l’adapter à vos besoins :

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

L’en-tête entre les trois tirets contient les métadonnées. Les principaux champs sont name (en lettres latines, avec des mots séparés par des tirets, et utilisé pour appeler le skill comme une commande) et description. L’agent utilise le champ description pour déterminer si le skill convient à la tâche en cours et s’il doit être chargé. Si la description est vague, le skill risque de ne pas être chargé lorsqu’il est nécessaire.

Les sections d’instructions suivent l’en-tête. When to Use indique quand charger le skill. Procedure donne les étapes à suivre. Pitfalls décrit les erreurs fréquentes de l’agent et comment les éviter. Verification explique comment vérifier le résultat. Si les instructions sont longues, déplacez le contenu principal vers des fichiers dans references/ ; ils ne seront chargés qu’en cas de besoin. Placez les programmes auxiliaires dans scripts/.

Si un skill nécessite une clé API, déclarez-la dans l’en-tête avec required_environment_variables ; ne mettez pas la clé elle-même dans le fichier, déclarez uniquement le nom de la variable. Lors du premier appel dans un terminal local, Hermes vous demandera la valeur une seule fois, puis la fournira automatiquement (dans les messageries, il vous invitera à configurer la clé localement). Les champs platforms, config, blueprint et les autres sont décrits dans la page de documentation officielle Creating Skills.

Une fois le fichier prêt, procédez comme suit :

1. Créer le dossier du skill

   mkdir -p ~/.hermes/skills/weekly-review
   

   Le nom du dossier correspond au champ name dans l’en-tête.

2. Enregistrer SKILL.md

   Placez un fichier nommé SKILL.md contenant vos instructions dans le dossier ; vous pouvez reprendre l’exemple ci-dessus et l’adapter à votre tâche.

3. Appeler le skill et le vérifier

   Saisissez /weekly-review et demandez à l’agent de faire le bilan de votre semaine. S’il suit les étapes indiquées dans vos instructions, le skill fonctionne.

Comment créer un skill à partir de documents existants avec /learn ?#

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

Si vous venez de terminer un processus compliqué avec l’agent, demandez à /learn de l’enregistrer sous forme de skill pendant que toutes les étapes figurent encore dans la conversation. La prochaine fois, Hermes répétera la procédure à l’aide des instructions prêtes à l’emploi.

Une source volumineuse, comme un livre, une spécification ou une archive de documents, ne tient pas dans un seul fichier. Hermes créera un fichier SKILL.md compact avec une carte des sujets et déplacera les détails dans references/. Ces fichiers n’occupent pas d’espace dans le contexte tant que l’agent ne les charge pas pour répondre à une question. Si vous relancez /learn sur le même sujet, il complète le skill existant au lieu d’en créer un doublon.

Comment vérifier qu’un skill fonctionne ?#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

C’est le test recommandé par la documentation : exécutez le skill et vérifiez que l’agent suit vos instructions. Si ce n’est pas le cas, vérifiez trois causes possibles. Premièrement, le nom du dossier ou le champ name dans l’en-tête ne correspond peut-être pas au nom que vous appelez. Deuxièmement, la description n’indique peut-être pas clairement quand le skill doit être utilisé ; reformulez-la en reprenant les mots de la tâche elle-même. Troisièmement, le dossier ne se trouve peut-être pas dans ~/.hermes/skills/, et Hermes ne peut donc pas le voir. Notez que l’option --toolsets skills limite l’ensemble d’outils du test : elle montre comment l’agent utilise l’instruction, mais ne vérifie pas les dépendances du skill, comme des programmes externes.

La commande hermes skills list dans le terminal affiche exactement ce qui est installé.

Les skills font partie d’un clone d’IA : ils permettent d’enregistrer une fois la manière dont vous effectuez une tâche afin que l’agent puisse la répéter sans rappel. L’ensemble comprend clone d’IA + Second Brain + Context Engineering. Il aide à transmettre à l’agent votre logique de travail et le contexte de la tâche.

Comment mettre à jour et supprimer des skills ?#

hermes skills check      # ce qui a changé dans les sources
hermes skills update     # télécharger les nouvelles versions
hermes skills uninstall pdf   # supprimer un skill du hub

Pour supprimer un skill que vous avez créé manuellement, effacez son dossier dans ~/.hermes/skills/. Si vous avez personnalisé le skill de quelqu’un d’autre, update le laissera intact : Hermes compare les hachages et ignore les fichiers modifiés pour éviter d’écraser votre travail. Pour restaurer l’original d’un skill du hub, utilisez hermes skills update name --force ; pour un skill intégré, utilisez hermes skills reset name --restore. Ces deux commandes écrasent vos modifications ; enregistrez donc votre version au préalable.

Si vous n’avez pas besoin des skills intégrés et qu’ils encombrent la liste, hermes skills opt-out désactivera leur ajout lors des mises à jour. La commande opt-out --remove supprimera également ceux que vous n’avez pas modifiés.

Que faire si un skill ne s’installe pas ou ne fonctionne pas ?#

Hermes trouve les skills dans les dossiers .hermes/skills/ et .agents/skills/ d’un dépôt Git. Avant de les charger, vous devez marquer le dépôt comme fiable : ces fichiers contiennent des instructions que l’agent suivra. Ensuite, les skills du dépôt ne fonctionnent qu’à l’intérieur de celui-ci et font l’objet du même contrôle de sécurité. Il suffit de marquer le dépôt comme fiable une seule fois.

Que faire en premier ?#

Pour poursuivre sur ce sujet : comment connecter Hermes Agent à Telegram, afin d’appeler des skills depuis votre téléphone, et comment faire fonctionner un agent en continu sur un serveur, si vous voulez des skills planifiés. Si vous choisissez un agent, consultez la comparaison OpenClaw ou Hermes Agent.