Inicio rápido: Claude Agent Teams en 3 pasos

Antes de empezar

Agent Teams es una feature experimental de Claude Code. Requiere el flag CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 y puede tener comportamientos no deterministas. No usar como pipeline de producción automatizado sin supervisión.

Prerrequisitos

• Claude Code — instalado y configurado con tu API key
• Docker — para levantar el portal Hermit
• jq — para verificar las skills via API (brew install jq en macOS)

Paso 1: Repositorio

1. Clona el repositorio:

   git clone https://github.com/nneira/claude-agent-teams-skill-factory
   cd claude-agent-teams-skill-factory

2. Copia el archivo de variables de entorno:

   cp .env.example .env

   El .env necesita tu token de Hermit — lo generas en el paso 3.

Paso 2: Habilitar Agent Teams

Agrega la variable experimental en ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Nota

Si el archivo no existe, créalo. Si ya tienes otras configuraciones en env, agrega la clave dentro del mismo objeto.

Paso 3: Portal Hermit

1. Clona y levanta Hermit:

   git clone https://github.com/hermit-labs/hermit
   cd hermit
   docker compose up -d

   Portal disponible en http://localhost:8080.

2. Genera el token de API:

   Abre http://localhost:8080/admin → Settings → API Keys → Generate.

3. Copia el token a tu .env en el repo del proyecto:

   HERMIT_TOKEN=tu_token_aqui
   HERMIT_URL=http://localhost:8080

Verificar que todo funciona

Confirma que Hermit responde correctamente:

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

Si devuelve un array vacío [] o los nombres de las skills existentes, todo está listo.

Usar la fábrica

Desde la raíz del proyecto, abre Claude Code:

claude

Ejemplo de prompt:

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

El Lead detecta las ambigüedades bloqueantes y pregunta antes de arrancar. Responde y el pipeline corre solo hasta publicar la skill en el portal.

Consejo

El Lead pregunta si la información faltante es bloqueante — si puede usar un placeholder genérico (<PROJECT_ID>, <REGION>), no pregunta. Solo pregunta cuando el proveedor o el scope son ambiguos y no pueden inferirse.

Verificar la skill publicada

Después de que el Publisher termine:

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

La skill también queda instalada localmente en ~/.claude/skills/nombre-skill/SKILL.md.

→ Ver la arquitectura completa