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.
Si platforms ne mentionne pas votre système, le skill n'apparaît tout simplement pas dans votre liste. Un skill qui fonctionne sur votre Mac peut disparaître sur un serveur Linux sans le moindre message d'erreur.
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/Le caractère ~ désigne votre dossier personnel : /Users/prenom sur macOS, /home/prenom sur Linux. Un dossier dont le nom commence par un point, comme .hermes, est masqué par défaut dans l'explorateur de fichiers.
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 demandetemplates/pour les formats de sortie réutilisablesscripts/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.
| Catégorie | Exemples livrés d'office | Exemples optionnels |
|---|---|---|
| Agents de codage | Claude Code, Codex, OpenCode | Grok, OpenHands, Honcho |
| Création | Excalidraw, pixel art, vidéo Manim | Blender MCP, diagrammes conceptuels |
| DevOps | Kanban Orchestrator, Webhook Subscriptions | Docker Management, Pinggy Tunnel |
| GitHub et développement | GitHub PR Workflow, TDD, Systematic Debugging | Code Wiki, REST/GraphQL Debug |
| Médias | Spotify, GIF Search, YouTube Content | AgentMail, Telephony |
| MLOps | Hugging Face Hub, vLLM, DSPy | Axolotl, Whisper, Pinecone, Qdrant |
| Recherche | arXiv, Blogwatcher, LLM Wiki | DuckDuckGo Search, OSINT Investigation |
| Sécurité | aucun | 1Password, Sherlock, Web Pentest |
| Finance | aucun | DCF Model, LBO Model, Excel Author |
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.
- 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/. - Lancez l'installation avec
hermes skills install. Hermes télécharge le skill et l'ajoute à votre bibliothèque locale. - 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.
- Retirez-le quand il ne sert plus, sans toucher aux autres.
hermes skills install official/blockchain/solana
hermes skills uninstall solanaUne 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.
Un skill tiers exécute du code sur votre machine avec vos identifiants. Avant d'installer un skill communautaire, ouvrez son dossier scripts/, lisez les appels réseau, et donnez-lui une clé d'API aux droits limités plutôt que votre jeton principal.
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.
| Votre besoin | Skills à regarder | Ce que vous y gagnez |
|---|---|---|
| Développement | github-pr-workflow, github-code-review, test-driven-development, systematic-debugging | Relire des PR, remonter à l'origine d'un bug, tenir une discipline de tests |
| Recherche | arxiv, blogwatcher, llm-wiki, youtube-content | Trouver des articles, suivre des blogs, résumer des transcriptions |
| Automatisation | kanban-orchestrator, kanban-worker, claude-code, codex | Déléguer des tâches et coordonner plusieurs exécutions |
| Productivité | google-workspace, notion, airtable, obsidian, ocr-and-documents | Gérer documents, notes, bases de données et PDF |
| Infrastructure | docker-management, huggingface-hub, llama-cpp, serving-llms-vllm | Gérer des conteneurs, récupérer et servir des modèles |
| Sécurité | 1password, oss-forensics, sherlock, web-pentest | Gérer des secrets, auditer un dépôt, mener des tests autorisés |
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
Faut-il installer les skills livrés avec Hermes Agent ?
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.
J'ai supprimé un skill livré d'office par erreur, comment le récupérer ?
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é.
Un skill remplace-t-il les outils de Hermes Agent ?
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.
Où placer la clé d'API dont un skill a besoin ?
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.
Combien de fichiers faut-il pour créer un skill ?
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.