Claude Code Agent Teams: fábrica de skills con 7 agentes

Qué es este sistema

claude-agent-teams-skill-factory es una arquitectura híbrida que combina Agent Teams y subagentes de Claude Code para construir una fábrica de instrucciones reutilizables (skills). Con un solo prompt, el equipo investiga, escribe, debate, comprime, valida y publica — sin intervención manual en el proceso.

El resultado: skills en formato SKILL.md publicadas en el portal Hermit y disponibles localmente para Claude, Cursor y cualquier agente compatible.

Los 7 agentes

Agent Team (4 sesiones de Claude Code):

Agente	Tipo	Responsabilidad
Lead	Lead del team	Orquesta todo el pipeline, lanza subagentes
Arquitecto	Teammate	Escribe el SKILL.md como instrucciones para Claude
Revisor	Teammate	Cuestiona si Claude ejecutaría correctamente las instrucciones
Optimizador	Teammate	Elimina todo lo que Claude ya sabe

Subagentes del Lead (sin sesión propia):

Agente	Tipo	Responsabilidad
Investigador	Subagente	Busca documentación oficial, devuelve research
Validador	Subagente	Ejecuta validate.sh, devuelve PASS/FAIL
Publisher	Subagente	Publica en el portal y verifica

Por qué dos capas

La distinción no es arbitraria — define herramientas disponibles, modelos asignados y costo:

• Teammates se comunican entre sí vía Mailbox. Necesitan debate para construir bien el artefacto. Agent Teams les asigna Opus automáticamente.
• Subagentes no tienen acceso al Task Tool, no pueden lanzar otros agentes, y heredan el modelo del Lead (Sonnet). Ejecutan una tarea acotada y devuelven resultado.

Regla de diseño: ¿los agentes necesitan hablarse para hacer bien el trabajo? Sí → Agent Team. No → Subagentes.

El modelo de modelos

Precaución

Agent Teams asigna Opus a todos los teammates automáticamente, sin importar lo que configures en el CLAUDE.md o en el spawn prompt. El Lead hereda el modelo de tu sesión activa. Los subagentes heredan el modelo del Lead. Haiku nunca fue usado en ninguna de las demos — datos confirmados de 37 llamadas analizadas.

Componente	Modelo real
Lead	Sonnet (hereda de tu sesión)
Arquitecto, Revisor, Optimizador	Opus (siempre, automático)
Investigador, Validador, Publisher	Sonnet (hereda del Lead)

El único ahorro posible: lanzar Investigador, Validador y Publisher sin team_name para mantenerlos como subagentes en Sonnet.

Qué genera el sistema

Una ejecución completa produce un SKILL.md validado y publicado:

skills/nombre-skill/
└── SKILL.md    ← instrucciones para Claude, < 500 líneas

La skill queda disponible en dos lugares:

• Portal Hermit: http://localhost:8080
• Local: ~/.claude/skills/nombre-skill/SKILL.md

Claude detecta las skills del portal automáticamente y elige la correcta sin que el usuario le diga cuál existe.

Tecnologías

Componente	Tecnología
Framework de agentes	Claude Code Agent Teams (experimental)
Portal de skills	Hermit (self-hosted, Docker)
Validación de skills	validate.sh + skills-ref (opcional)
Publicación	publish.sh + API Hermit
Modelo teammates	Claude Opus 4.6 (automático)
Modelo Lead + subagentes	Claude Sonnet 4.6 (heredado)

→ Inicio rápido: instalación y configuración