Agente, sub-agente y skill
Cómo Claude Code organiza las instrucciones y tareas
Cuando empiezas con Claude Code, todo suena igual: agent, sub-agent, skill, MCP. En tres sesiones te das cuenta de que son capas distintas, y que confundirlas es exactamente lo que hace que el agente produzca output errático. La jerarquía no es cosmética — determina qué decide qué y qué ejecuta qué.
El [[agente]] decide, el [[sub-agente]] se especializa, y la [[skill]] es el manual operativo que cada uno sigue.
Las tres capas
Un agente es la instancia principal: recibe tu objetivo, planea, toma decisiones y delega. Es la capa que conversa contigo.
Un sub-agente es un agente especializado que el principal invoca para tareas acotadas. Ejemplo: tienes un sub-agente "db-writer" que solo toca migrations y policies de Supabase. Cuando el principal necesita tocar la DB, delega y se enfoca en otra cosa mientras.
Una skill es un archivo — generalmente .md — con instrucciones específicas: cómo comportarse, qué convenciones seguir, qué NO hacer. Se carga cuando el contexto lo pide. Pensalo como un procedimiento operativo escrito.
Por qué importa la jerarquía
Sin sub-agentes, el context-window del agente principal se satura rápido. Cada sub-agente tiene su propio contexto acotado → menos ruido, más foco.
Sin skills, cada sesión empieza re-explicando convenciones. Con skills bien escritas, abres Claude Code y el agente ya "sabe" cómo tratas el repo.
En tu proyecto actual, ¿qué responsabilidad podrías mover a una skill (documento vivo, no prompt) y qué a un sub-agente (ejecutor acotado)? Escribe una lista de 3 skills y 2 sub-agentes que harían tu próxima sesión más eficiente.
- Agente principal decide y delega; sub-agentes ejecutan tareas especializadas.
- Skills son manuales operativos que el agente consulta antes de actuar.
- Separar capas evita que el [[context-window]] se sature con ruido cruzado.