Format SKILL.md · Skill Bundles · Activation conditionnelle · Évolution GEPA · Publication Tap · agentskills.io
Hermes Agent tourne, mais vous collez encore les mêmes prompts chaque session ? Nous Research a lancé Hermes début 2026 ; 160 000 étoiles GitHub en deux mois. La thèse n'est pas un modèle plus grand, mais « the agent that grows with you ». Le moteur est le système Skills : mémoire procédurale standardisée, évolutive et cross-session. Ce guide couvre SKILL.md, Progressive Disclosure, Skill Bundles, activation conditionnelle, publication Tap, GEPA + DSPy auto-évolution et l'écosystème open source — avec tableaux comparatifs, runbook six étapes et FAQ.
Contrairement aux prompts ponctuels, les skills Hermes suivent le standard ouvert agentskills.io : persistants entre sessions, chargés à la demande, publiable en Tap communautaire, portable vers Claude Code et Cursor. Si Hermes est déjà installé, voir le guide d'installation et l'article sur la mémoire. Cet article se concentre uniquement sur la couche Skills.
Prompts comme skills : injection complète chaque session ; tokens croissants linéairement ; pas de réutilisation procédurale cross-session.
Confondre Memory et Skills : Memory stocke préférences et faits ; Skills stockent des SOP — timing de chargement et maintenance différents.
Champs description faibles : le routage Level 0 utilise name + description. Décrire « ce que c'est » plutôt que « quand l'utiliser » provoque erreurs ou jamais chargé.
SKILL.md monolithiques : plus de 500 lignes atteint la limite GEPA 15KB et augmente le coût token Level 1.
Hôtes instables : la cumulation de skills exige une disponibilité 24 h/24 ; les portables en veille cassent la collecte sessiondb pour GEPA — la stabilité du système est critique.
Prompt = note adhésive. Memory = carnet. Skill = manuel SOP — zéro coût token avant activation.
| Dimension | Prompt | Memory | Skills |
|---|---|---|---|
| Persistance | Chat courant | Cross-session, permanent | Cross-session, permanent |
| Chargement | Toujours en contexte | Auto-injecté chaque session | À la demande |
| Coût token | Chaque tour | Petit, stable | Zéro avant activation |
| Type de contenu | Intention libre | Préférences/faits | Étapes procédurales |
| Maintenance | Manuelle | Agent auto | User + Agent |
| Partageable | Difficile | Privé | Tap communautaire |
Frontmatter requis : name (minuscules + tirets, max 64 car.) et description (max 1024 car., début « Use when... »). Recommandé : version, license, compatibility, allowed-tools expérimental. Sections : Overview, When to Use, Procedure, Common Pitfalls, Verification Checklist.
---
name: my-skill
description: |
Use when the user needs to [...].
Handles [...] and [...].
version: 1.0.0
metadata:
hermes:
requires_toolsets: [terminal]
fallback_for_toolsets: [web]
---
Arborescence sous ~/.hermes/skills/my-category/my-skill/ : SKILL.md (cœur, max ~500 lignes), references/ (docs API), templates/, scripts/ (exécutables par l'agent).
| Niveau | Contenu | Trigger | Coût token |
|---|---|---|---|
| Level 0 | name + description | Début session, tous skills | ~3K total |
| Level 1 | Corps SKILL.md complet | /skill-name ou match LLM | Longueur fichier |
| Level 2 | references/ scripts/ | LLM pendant exécution | Par fichier |
Un Bundle est un YAML léger à ~/.hermes/skill-bundles/<slug>.yaml. /bundle-name charge tous les skills listés. Bundle bat un Skill homonyme ; skills manquants ignorés silencieusement ; Bundles ne modifient pas les prompts système (token-friendly).
name: backend-dev description: Full backend feature workflow. skills: - github-code-review - test-driven-development - github-pr-workflow instruction: | Always write failing tests first. Never push directly to main.
CLI : hermes bundles create backend-dev --skills github-code-review,test-driven-development,github-pr-workflow. Avancé : research-session (arxiv + deep-research + plan + excalidraw) et mlops-deploy (vllm + llama-cpp + github-pr-workflow + systematic-debugging).
Configuration sous metadata.hermes : requires_toolsets/tools masque le skill sans outils listés ; fallback_for_toolsets/tools masque quand outils listés existent (chemin fallback). Exemple : DuckDuckGo avec fallback_for_tools: [web_search] — avec FIRECRAWL_KEY ou BRAVE_SEARCH_KEY, DuckDuckGo disparaît ; si API down, le fallback apparaît.
Créer le répertoire : SKILL.md sous ~/.hermes/skills/<category>/<skill-name>/ avec triggers « Use when... » clairs.
Splitter references : docs API vers references/ après 500 lignes ; rester sous 15KB pour garde-fous GEPA.
Valider le format : skills-ref validate ./my-skill pour conformité agentskills.io.
Tester l'activation : nouvelle session, /my-skill ou match description ; confirmer Level 1 et Procedure.
Bundle (optionnel) : hermes bundles create <name> --skills a,b,c pour workflows one-shot.
Publier Tap : repo GitHub + hermes skills tap add github:your-org/your-skills-tap ; équipe exécute tap update.
hermes skills install official/research/arxiv hermes skills install github:openai/skills/k8s hermes skills tap add github:my-org/my-skills hermes skills tap update hermes skills tap list
| Dépôt | Description | Point fort |
|---|---|---|
| ChuckSRQ/awesome-hermes-skills | Skills production curatés | Deep Research, MLOps, intégration Apple |
| amanning3390/hermeshub | Registre communautaire | Scan sécurité, marketplace, détection injection |
| kevinnft/ai-agent-skills | 191 skills, 28 catégories | Hermes / Claude Code / Cursor one-click |
| NousResearch/hermes-agent | Repo officiel | Skills intégrés et spec d'écriture |
Repos Tap avec dossiers catégories (mlops/, research/) plus skills.sh.json optionnel pour groupement Hub. Repos privés : hermes skills tap add github:your-org/private-skills --token $GH_TOKEN. Versionner ~/.hermes/skills/ avec Git ; sync via git pull && hermes skills reset.
Les plugins packagent skills en plugin:skill : masqués dans skills_list, opt-in uniquement, skills siblings référencent entre eux. Charger avec skill_view("superpowers:writing-plans"). Déclarer chemins dans plugin.yaml.
Cross-plateforme : le même SKILL.md fonctionne sur Hermes, Claude Code, Cursor, OpenCode. Copier vers ~/.claude/skills/ ou scripts kevinnft/ai-agent-skills.
GEPA (Genetic-Pareto Prompt Evolution) est un travail ICLR 2026 Oral intégré dans hermes-agent-self-evolution. Pipeline : collecter traces d'exécution → analyse réflexive des échecs → générer 10–20 variantes SKILL.md → évaluation Pareto multi-objectif (succès × efficacité token × vitesse) → meilleure variante ouvre PR pour revue humaine. Coût : environ 2–10 USD par run, API seule, pas de GPU.
export HERMES_AGENT_PATH=~/.hermes
python -m evolution.skills.evolve_skill \
--skill github-code-review --iterations 10 --eval-source synthetic
python -m evolution.skills.evolve_skill \
--skill github-code-review --iterations 10 --eval-source sessiondb
python -m evolution.skills.evolve_skill \
--skill github-code-review --iterations 10 --eval-source mixed \
--trace-dirs ~/.claude/traces,~/.hermes/sessions
Quatre garde-fous : pytest complet ; Skills ≤15KB, descriptions outils ≤500 car. ; Prompt Cache safe ; préservation sémantique. Roadmap : Phase 1 fichiers Skill (done) → descriptions outils → prompts système → code outils → boucle entièrement automatisée.
agent_writes_require_approval: true dans config.yamlPack seo-keyword-research, outline-generator, code-example-validator, bilingual-checker, publish-to-platform. Instruction : SEO d'abord, tester exemples code, titres bilingues. seo-keyword-research description cible planification blog ; Procedure produit matrice mots-clés FR/EN long-tail.
Portables et VPS x86 peuvent exécuter Hermes CLI mais cassent cumulation skills, collecte GEPA sessiondb et skills navigateur macOS. Pour équipes traitant Skills comme actifs production avec stabilité système, la location cloud Mac Mini M4 regroupe uptime 24 h/24, UMA et launchd en OpEx prévisible.
Quand votre stack Skills est prête et vous avez besoin d'un hôte production, VpsMesh propose location cloud Mac Mini M4 avec livraison SSH et sauvegarde complète ~/.hermes/. Tarifs : tarifs location, aide : centre d'aide, commande : page de commande.
Skills = docs procéduraux ; MCP = interface outils. Complémentaires : MCP donne accès DB, un Skill enseigne les étapes de migration. Voir MCP Server from scratch.
Modifications non appliquées en session courante. /reset ou install avec --now (invalide Prompt Cache, coût token plus élevé).
Quatre garde-fous : tests pass, limite 15KB, Prompt Cache safe, check sémantique. Meilleures variantes ouvrent PRs avec revue humaine avant merge.
Copier SKILL.md vers ~/.claude/skills/ ou répertoire skills Cursor ; ou kevinnft/ai-agent-skills. agentskills.io maintient format cohérent.
VPS x86 pour CLI API-only. Pour GEPA sessiondb, skills navigateur macOS ou sync Git Tap, location Mac Mini M4 plus stable. Tarifs : tarifs location.