Demo: 4 skills construidas por el equipo de agentes

Cómo correr el pipeline

Desde la raíz del proyecto:

claude

Luego en lenguaje natural, dile qué skill necesitas. El Lead detecta ambigüedades y pregunta antes de arrancar.

Demo 1: GCP VM con Terraform

Prompt de entrada:

Necesito una skill para crear una VM en Google Cloud con Terraform.

Lo que pasó:

El Lead preguntó el tipo de instancia y la región antes de arrancar. Con esa información, lanzó el Investigador que buscó en la documentación oficial de Terraform para Google Cloud.

Fase 2 — El debate:

El Arquitecto escribió el SKILL.md con el recurso google_compute_instance y todas las dependencias de red
El Revisor encontró un bug real: un argumento de red que Terraform habría rechazado en ejecución
El Arquitecto corrigió y el Revisor aprobó en la segunda revisión

Fase 3 — Optimización: El Optimizador comprimió la skill de 247 a 157 líneas, eliminando 5 bloques de contexto que Claude ya conoce sobre Terraform.

Resultado:

✅ Validación pasada: 0 errores, 0 advertencias
✅ Skill publicada en el portal: gcp-vm-terraform
📥 Instalada localmente en: ~/.claude/skills/gcp-vm-terraform/

Demo 2: AWS S3 con boto3

Prompt de entrada:

Necesito una skill para crear un bucket S3 con boto3.

Lo que pasó:

El Lead no preguntó — el scope era suficientemente claro para arrancar con placeholders (<BUCKET_NAME>, <REGION>, <AWS_PROFILE>).

El Investigador buscó en la documentación oficial de boto3 (boto3.amazonaws.com). Documentó los métodos exactos para creación de bucket, configuración de bloqueo de acceso público y verificación.

Debate del equipo:

El Revisor cuestionó si la skill manejaba correctamente la diferencia de región (us-east-1 no acepta LocationConstraint, las demás sí)
El Arquitecto añadió la lógica condicional
El Optimizador eliminó los comentarios explicativos sobre qué es un bucket y qué es boto3 — Claude ya lo sabe

Resultado:

✅ Validación pasada: 0 errores, 1 advertencia (sección Referencias)
✅ Skill publicada en el portal: aws-s3-boto3

Demo 3: Google Workspace grupos con GAM

Prompt de entrada:

Necesito una skill para crear grupos de Google Workspace con GAM.

Lo que pasó:

El Lead preguntó si los grupos debían incluir configuración de permisos o solo creación básica — el scope era ambiguo.

El Investigador consultó la documentación oficial de GAM CLI y documentó los comandos exactos para creación de grupos, configuración de permisos de envío y adición de miembros.

Debate:

El Revisor detectó que faltaba el manejo del caso donde el grupo ya existe
El Arquitecto añadió la verificación previa con gam info group <GROUP_EMAIL>
En la segunda revisión, el Revisor aprobó sin nuevas objeciones

Resultado:

✅ Validación pasada: 0 errores, 0 advertencias
✅ Skill publicada en el portal: gam-create-group

Demo 4: Amazon SES identidad de email

Prompt de entrada:

Necesito una skill para crear y verificar una identidad de email en Amazon SES.

Lo que pasó:

El Investigador buscó en la documentación oficial de AWS CLI v2 para SES v2. Documentó el flujo completo: create-email-identity, verificación del status DKIM, y el tiempo de propagación esperado.

Debate:

El Revisor señaló que la skill no cubría el caso de identidad ya existente (status PENDING_VERIFICATION vs SUCCESS)
El Arquitecto añadió la lógica de verificación de status antes de crear
El Optimizador comprimió eliminando la explicación de qué es DKIM — Claude ya sabe qué es

Resultado:

✅ Validación pasada: 0 errores, 0 advertencias
✅ Skill publicada en el portal: aws-ses-email-identity

Las 4 skills en el portal

Después de las 4 demos, el portal Hermit muestra todas las skills disponibles:

curl -s http://localhost:8080/api/v1/skills \
  -H "Authorization: Bearer $HERMIT_TOKEN" | jq '.[] | {name, description}'

[
  {"name": "gcp-vm-terraform", "description": "Crea una VM en Google Cloud..."},
  {"name": "aws-s3-boto3", "description": "Crea un bucket S3..."},
  {"name": "gam-create-group", "description": "Crea un grupo de Google Workspace..."},
  {"name": "aws-ses-email-identity", "description": "Verifica una identidad de email en SES..."}
]

Claude elige la skill sin que se lo digas

En una nueva sesión de Claude Code (sin contexto previo), Claude detecta las skills del portal y elige la correcta basándose en la descripción de la tarea:

> Necesito crear un bucket en S3 para almacenar los logs de la aplicación.

Claude selecciona aws-s3-boto3 automáticamente — sin que el usuario le diga qué skill existe o cuál usar.

→ Ver la arquitectura completa del sistema