SOP
Quince minutos. Doce líneas de YAML. Un workflow que antes te tomaba 4 minutos de setup ahora se ejecuta con un slash command.
Un skill bundle agrupa skills de Hermes Agent bajo un solo slash command con una instrucción permanente. Sirve para codificar workflows repetitivos en un archivo YAML de 12 líneas y ejecutarlos con un solo comando desde cualquier plataforma.
Cuándo usarlo: cada vez que hacés un workflow más de dos veces.
~/.hermes/skills/Un skill bundle se define en ~/.hermes/skill-bundles/{nombre}.yaml con esta estructura:
`yaml
name: nombre-del-bundle
description: Descripción corta de qué hace el bundle.
skills:
- skill-uno
- skill-dos
- skill-tres
instruction: |
Instrucciones permanentes para el agente.
Se cargan cada vez que ejecutás el slash command.
`
Tres partes: nombre + skills + instrucción. Eso es todo.
Analizá qué tarea hacés recurrentemente y que requiere múltiples skills + contexto.
Preguntas para identificar un buen candidato:
Si respondiste que sí a 2 o más, es candidato a bundle.
| Bundle | Skills | Output |
|---|---|---|
| backend-dev | github-code-review, test-driven-development, github-pr-workflow | PR listo con tests y revisión |
| handsome-x | x-articles, voice-profile, story-system, hooks-db | Artículo para X en tu voz |
| youtube-package | youtube-content, thumbnail-gen, hook-validation | Script + thumbnail + hook |
| shopify-ops | product-copy, listing-optimizer, image-briefs | Listing completo de producto |
Dos formas:
`bash
hermes bundles create nombre-del-bundle
`
Te guía paso a paso: nombre, descripción, skills, instrucción.
Creá el archivo manualmente:
`bash
mkdir -p ~/.hermes/skill-bundles
cat > ~/.hermes/skill-bundles/mi-bundle.yaml << 'EOF'
name: mi-bundle
description: Descripción de mi bundle.
skills:
- skill-uno
- skill-dos
instruction: |
Instrucción para el agente.
EOF
`
El bundle se activa automáticamente al guardar el archivo.
El bundle se invoca con un slash command:
`
/mi-bundle descripción de la tarea
`
El agente carga los skills especificados, aplica la instrucción permanente y ejecuta la tarea.
Los bundles evolucionan. Después de usar un bundle varias veces:
instruction si el agente se salta pasos importantes| Indicador | Bueno | Malo |
|---|---|---|
| Tiempo de setup | 0 segundos (slash command) | >30 segundos buscando contexto |
| Correcciones por uso | 0-1 | 3+ |
| Skills cargados | 2-4 exactamente | 1 (poco útil) o 5+ (demasiado) |
| Frecuencia de uso | >1 vez por semana | 1 vez al mes o menos |
| Skill | Bundle recomendado |
|---|---|
| github-code-review | backend-dev, code-review |
| test-driven-development | backend-dev, feature-work |
| x-articles | content-production, handsome-x |
| viral-hooks-database | content-production, social-media |
| gif-search | social-media, casual |
| excalidraw | architecture, planning |
| plan | cualquier bundle de desarrollo |
| copywriting | marketing, landing-pages |
| seo-audit | content-production, marketing |
| hyperframes | content-production, video |
Cuando armás tu primer skill bundle, los errores más típicos no vienen de la sintaxis YAML, sino de asumir que Hermes conoce tus skills por el nombre que vos les diste. El YAML es estricto: si en el archivo del skill el nombre tiene un guión o un espacio y en el bundle escribiste el nombre de otra forma, el comando no va a encontrar nada. Otro clásico: olvidarte de la ruta. Los skills tienen que estar en ~/.hermes/skills/ y los bundles en ~/.hermes/skill-bundles/. Si moviste archivos de carpeta, el bundle puede cargar pero después fallar en la primera skill.
También es frecuente que el campo `instruction` quede vacío, sobre todo cuando copiás la estructura de memoria. Ese campo es lo que hace que el agente se comporte distinto con cada bundle. Si no le das una instrucción clara —por ejemplo, 'Revisá el código con foco en seguridad y devolvé un resumen en español rioplatense'—, el resultado va a ser genérico y probablemente no te ahorre los dos minutos que querías ahorrar. Ponete a pensar qué contexto repetís cada vez que hacés la tarea a mano: eso va en `instruction`.
La forma más rápida de evitar estos problemas es probar el bundle apenas lo creás. Ejecutá el slash command en una conversación de prueba y fijate si carga las skills y si la instrucción se aplica. Si algo falla, revisá los logs (`hermes logs`) y compará los nombres exactos de los archivos de skills. Y cuando ya funcione, actualizá el bundle cada vez que cambies un skill o un paso del workflow: un bundle desactualizado es peor que no tener bundle, porque te da falsa confianza. Así, en dos o tres usos, lo vas a afinar y va a quedar como un atajo sólido.