SOP: Cómo crear tu primer Skill Bundle en Hermes Agent

Quince minutos. Doce líneas de YAML. Un workflow que antes te tomaba 4 minutos de setup ahora se ejecuta con un slash command.

2026-05-21

¿Para qué sirve?

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.

Requisitos previos

  • Hermes Agent instalado (última versión)
  • Al menos 2 skills instalados (del Skills Hub o creados por vos)
  • Archivos de skill en ~/.hermes/skills/

Estructura de un skill bundle

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.

Paso 1: Identificar el workflow

Analizá qué tarea hacés recurrentemente y que requiere múltiples skills + contexto.

Preguntas para identificar un buen candidato:

  • ¿Este workflow lo hago al menos 1 vez por semana?
  • ¿Requiero cargar 2+ skills cada vez?
  • ¿Tengo que explicar mi tono/estilo cada vez que empiezo?
  • ¿Me lleva más de 2 minutos configurar la sesión?

Si respondiste que sí a 2 o más, es candidato a bundle.

### Ejemplos reales

BundleSkillsOutput
backend-devgithub-code-review, test-driven-development, github-pr-workflowPR listo con tests y revisión
handsome-xx-articles, voice-profile, story-system, hooks-dbArtículo para X en tu voz
youtube-packageyoutube-content, thumbnail-gen, hook-validationScript + thumbnail + hook
shopify-opsproduct-copy, listing-optimizer, image-briefsListing completo de producto

Paso 2: Crear el bundle

Dos formas:

### Opción A: CLI interactiva

`bash hermes bundles create nombre-del-bundle `

Te guía paso a paso: nombre, descripción, skills, instrucción.

### Opción B: YAML directo

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.

Paso 3: Usar el bundle

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.

### Dónde funciona

  • CLI de Hermes
  • Dashboard web
  • Telegram (si conectaste el gateway)
  • Discord
  • Slack

Paso 4: Iterar y mejorar

Los bundles evolucionan. Después de usar un bundle varias veces:

  1. Ajustá la instruction si el agente se salta pasos importantes
  2. Agregá o sacá skills según lo que realmente necesitás
  3. Si el bundle se vuelve muy específico, partilo en dos bundles más enfocados

### Señales de que un bundle necesita ajuste

  • El agente pregunta algo que ya debería saber por la instrucción
  • Tenés que corregir el output siempre de la misma manera
  • El bundle cubre dos escenarios muy distintos

Métricas de éxito

IndicadorBuenoMalo
Tiempo de setup0 segundos (slash command)>30 segundos buscando contexto
Correcciones por uso0-13+
Skills cargados2-4 exactamente1 (poco útil) o 5+ (demasiado)
Frecuencia de uso>1 vez por semana1 vez al mes o menos

Referencia: lista de skills útiles para bundles

SkillBundle recomendado
github-code-reviewbackend-dev, code-review
test-driven-developmentbackend-dev, feature-work
x-articlescontent-production, handsome-x
viral-hooks-databasecontent-production, social-media
gif-searchsocial-media, casual
excalidrawarchitecture, planning
plancualquier bundle de desarrollo
copywritingmarketing, landing-pages
seo-auditcontent-production, marketing
hyperframescontent-production, video
— Ariel Di Stefano