Hermes Agent Skills – Guide avancé : SKILL.md, auto-évolution GEPA et Skill Bundles (2026)

Si vous maitrisez deja l installation Hermes mais que vos Skills restent des fichiers isoles, que les Bundles ne declenchent rien et que GEPA vous semble reserve aux chercheurs, ce guide est pour vous — responsables techniques d equipes Agent et auteurs cross-plateforme Cursor/Claude Code. Nous couvrons SKILL.md agentskills.io, Bundles YAML, activation conditionnelle, Tap GitHub, evolution GEPA/DSPy, un cas blog complet, un runbook Mac cloud en cinq etapes et une FAQ ; conclusion : un Gateway 7j/7 sur noeud VPSMAC fait compoundre la bibliotheque de Skills.

Schema : Hermes Agent Skills avec SKILL.md, Skill Bundles YAML, pipeline GEPA et Gateway permanent sur Mac cloud Apple Silicon

Table des matieres

1. Pourquoi approfondir le systeme Skills de Hermes ?

Debut 2026, Hermes Agent de Nous Research depasse 160 000 etoiles GitHub. Sa these n est pas un modele plus grand mais the agent that grows with you — un Agent qui s enrichit session apres session. Le moteur de cette croissance, ce sont les Skills : memoire procedurale standardisee, evolutive et persistante entre les sessions.

Contrairement aux prompts jetables, un Skill Hermes suit agentskills.io, se charge a la demande et peut etre partage via Tap, optimise par GEPA ou empaquette en Bundle. Ce guide ignore l installation de base et entre directement dans la zone avancee.

  1. Cout token incontrôlé : sans Progressive Disclosure, des dizaines de Skills en tete de session saturent le contexte avant la premiere tache utile.
  2. Workflows fragmentes : PR review, TDD et deploiement restent trois Skills separes ; sans Bundle, l equipe oublie d en activer un a chaque session.
  3. Skills statiques sur hardware instable : un Gateway qui dort (portable ferme, VPS Linux sans macOS) empeche Cron, webhooks et evolution GEPA de tourner — voir notre article sur la memoire a trois couches Hermes.

2. Skills, Memory et Prompts : trois couches distinctes

DimensionPromptMemorySkill
PersistanceSession couranteInter-sessions, permanentInter-sessions, permanent
ChargementToujours en contexteInjecte a chaque sessionA la demande
Cout tokenA chaque tourFaible et stableZero avant activation
ContenuIntention librePreferences, faits utilisateurEtapes procedurales
MaintenanceManuelleAgent automatiqueUtilisateur + Agent
PartageDifficilePrivePubliable en Tap communautaire

Mnemonique : Prompt = post-it ; Memory = carnet toujours ouvert ; Skill = manuel SOP consulte quand necessaire. Les Rules Cursor couvrent le style ; les Skills Hermes couvrent les procedures multi-etapes — comparez avec notre guide Cursor Agent Skills pour le pont cross-plateforme.

3. Format SKILL.md et chargement progressif

Tous les Skills Hermes respectent le standard ouvert agentskills.io (portables vers Claude Code, Cursor, OpenCode).

--- name: my-skill description: | Use when the user needs to [...]. Handles [...] and [...]. version: 1.0.0 metadata: hermes: tags: [devops, automation] requires_toolsets: [terminal] --- # My Skill Title ## Procedure 1. Etape avec commande exacte 2. Etape suivante ## Common Pitfalls - Mode d echec concret + correctif

Arborescence modulaire recommandee :

~/.hermes/skills/my-category/my-skill/ ├── SKILL.md ├── references/api-docs.md ├── templates/config.yaml └── scripts/setup.sh
NiveauContenuDeclencheurCout token
Level 0name + descriptionDebut de session, catalogue complet~3K (tous Skills)
Level 1Corps SKILL.md/skill-name ou jugement LLMSelon taille fichier
Level 2references/, scripts/Execution pas a pasSortie script uniquement

Regle d or : le champ description est votre cle de routage Level 0. Ecrivez quand charger, pas ce que c est.

4. Skill Bundles : une commande, tout le workflow

Les Skill Bundles (2026) empaquettent plusieurs Skills dans un seul slash command. Fichier : ~/.hermes/skill-bundles/<slug>.yaml.

name: backend-dev description: | Full backend feature workflow — code review, TDD, PR management. skills: - github-code-review - test-driven-development - github-pr-workflow instruction: | Always write failing tests first before implementation. Never push directly to main.

Regles de priorite : Bundle bat Skill homonyme ; Skill manquant = ignore avec avertissement ; Bundle ne modifie pas le system prompt (compatible Prompt Cache).

hermes bundles create backend-dev \ --skills github-code-review,test-driven-development,github-pr-workflow \ --instruction "Always write failing tests first"

5. Activation conditionnelle : Skills sensibles au contexte

Dans metadata.hermes, quatre champs pilotent la visibilite selon les outils disponibles :

ChampComportement
requires_toolsetsMasque si l outilset liste est absent
requires_toolsMasque si l outil liste est absent
fallback_for_toolsetsMasque si l outilset de repli est present
fallback_for_toolsMasque si l outil de repli est present
# duckduckgo-search/SKILL.md metadata: hermes: fallback_for_tools: [web_search] # cache si web_search payant actif

Cas classique : basculer automatiquement entre recherche payante (Brave/Firecrawl) et DuckDuckGo gratuit selon les cles API configurees — economie de tokens et de cout API.

6. Skills Hub et ecosysteme open source

hermes skills install official/research/arxiv hermes skills install github:openai/skills/k8s hermes skills tap add github:my-org/my-skills
DepotDescriptionPoints forts
awesome-hermes-skillsCollection productionDeep Research, MLOps, integration Copilot
hermeshubRegistre communautaireScan anti-injection, marketplace API
ai-agent-skills191 Skills, 28 categoriesHermes / Claude / Cursor cross-agent
hermes-agentOfficiel Nous ResearchSource autoritaire, specs internes

Validez le format avec skills-ref validate ./my-skill avant publication.

7. Publier votre Skill Tap : partage equipe et communaute

my-skills-tap/ ├── skills.sh.json ├── mlops/vllm-deploy/SKILL.md └── research/paper-summarizer/SKILL.md
hermes skills tap add github:your-org/your-skills-tap hermes skills tap add github:your-org/private-skills --token $GH_TOKEN hermes skills tap update hermes skills tap list

Versionnez ~/.hermes/skills/ dans Git pour synchroniser postes et noeuds cloud. Apres git pull, executez hermes skills reset pour reconstruire les Skills built-in.

8. Auto-evolution GEPA + DSPy : Skills qui s ameliorent seuls

GEPA (Genetic-Pareto Prompt Evolution), presente a ICLR 2026 Oral, est integre dans hermes-agent-self-evolution. Principe : optimiser le texte du Skill via trajectoires d execution, sans fine-tuning des poids du modele. Cout typique : 2–10 USD par run (API uniquement, pas de GPU).

Cinq etapes : (1) collecte trajectoires SQLite ; (2) analyse reflexive des echecs ; (3) mutation ciblee — 10–20 variantes SKILL.md ; (4) evaluation Pareto multi-objectifs (succes × tokens × latence) ; (5) PR humaine avant merge.

git clone https://github.com/NousResearch/hermes-agent-self-evolution cd hermes-agent-self-evolution && pip install -r requirements.txt export HERMES_AGENT_PATH=~/.hermes python -m evolution.skills.evolve_skill \ --skill github-code-review \ --iterations 10 \ --eval-source sessiondb
PhaseCibleMoteurStatut
Phase 1Fichiers SKILL.mdDSPy + GEPAImplemente
Phase 2Descriptions outilsDSPy + GEPAPlanifie
Phase 3Fragments system promptDSPy + GEPAPlanifie
Phase 4Code outilsDarwinian EvolverPlanifie
Phase 5Boucle continue automatiquePipeline CIPlanifie

Quatre garde-fous obligatoires : tests pytest 100 % ; Skills ≤ 15 KB ; compatibilite Prompt Cache ; controle semantique anti-derive.

9. Skills embarques dans les plugins

Les plugins exposent des Skills en namespace plugin:skill, opt-in, absents du skills_list par defaut :

skill_view("superpowers:writing-plans") # plugin.yaml name: my-hermes-plugin skills: - name: writing-plans path: skills/writing-plans/SKILL.md

10. Techniques avancees d ecriture

Description precise :

# ❌ Trop vague description: Helps with code. # ✅ Declencheurs explicites description: | Use when reviewing a pull request for security or style issues. Do NOT use for writing new code.

La section Common Pitfalls distingue les Skills matures : echecs concrets, cause racine, correctif actionnable. Utilisez skill_manage(action='patch', ...) pour maintenance dynamique ; activez agent_writes_require_approval: true en production.

Taille SkillRecommandation
< 500 lignesTout dans SKILL.md
500–1000 lignesDetails dans references/
> 1000 lignesScinder en deux Skills
> 15 KBLimite GEPA — decouper obligatoire

11. Cas pratique : workflow blog technique

# ~/.hermes/skill-bundles/blog-workflow.yaml name: blog-workflow description: Full tech blog writing workflow. skills: - seo-keyword-research - outline-generator - code-example-validator - bilingual-checker - publish-to-platform instruction: | Always research SEO keywords before writing. Ensure all code examples are tested and runnable.

Le Skill seo-keyword-research declenche sur planification d article, recherche longue traine CN/EN et croise tendances Dev.to / HN. Combine avec requires_toolsets: [web] pour activation conditionnelle.

12. Runbook en cinq etapes : Skills production sur Mac cloud VPSMAC

Etape 1 — Choisir le noeud M4

Selectionnez un noeud VPSMAC 16/32 GB UMA avec SSH, IP publique et macOS natif — prerequis pour launchd, Keychain et scripts Apple.

Etape 2 — Installer Hermes et abonner les Tap

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup hermes skills tap add github:your-org/your-skills-tap hermes skills install official/research/arxiv

Etape 3 — Deployer Bundles et valider

Copiez vos YAML dans ~/.hermes/skill-bundles/. Testez /backend-dev en CLI ; validez chaque Skill avec skills-ref validate.

Etape 4 — Daemon launchd et sauvegarde

Enregistrez le Gateway avec KeepAlive, logs dans ~/Library/Logs/hermes/, sauvegarde chiffree de ~/.hermes — voir noeud Agent Mac cloud.

Etape 5 — Boucle GEPA staging

Sur branche staging, lancez evolve_skill avec --eval-source sessiondb ; revue PR humaine avant merge sur le noeud production.

13. FAQ

Skills vs MCP ? Skills = runbooks proceduraux ; MCP = interfaces outils. Complementaires.
Skill modifie mais ancienne version ? /reset ou hermes skills install --now (invalide Prompt Cache).
GEPA sur ? Quatre garde-fous + revue PR ; ne jamais auto-merge sans diff review.
Reutiliser dans Claude Code ? Copiez vers ~/.claude/skills/ ou installez via ai-agent-skills.
Contenu chinois et tokens ? CJK ~1–1,5 token/caractere ; gardez description en anglais pour routage LLM optimal.

14. Ressources et liens

15. Conclusion : Skills repondent au « comment », Mac cloud repond au « toujours actif »

Empiler des prompts ou ignorer les Bundles laisse vos workflows Agent fragiles et non versionnes. Docker sur VPS Linux ou WSL2 peut heberger des scripts, mais sans macOS natif, launchd 7j/7 et toolchain Apple, les Skills qui supposent xcodebuild, notarisation ou Keychain echouent en production. Les portables interrompent Cron et webhooks ; l evolution GEPA exige un hote stable qui accumule des trajectoires sessiondb.

Pour des equipes qui traitent Hermes Skills, Bundles et Tap comme infrastructure — pas comme astuces de chat — louer un noeud Mac cloud VPSMAC offre macOS bare-metal, SSH, launchd permanent et sauvegarde ~/.hermes previsible. Versionnez vos Skills en Git, synchronisez sur le noeud, laissez GEPA ameliorer les runbooks pendant que le Gateway tourne entre vos sprints.