La creación de subagentes, skills y comandos es el paso que hay que dar para volverse un power user de Claude Code. Esto es lo que te va a permitir guiar al agente y que deje de ser un generalista para que se vuelva muy bueno en tu proyecto.

Las diferencias

Comandos son para ejecutar acciones repetitivas. Cosas que hacés seguido y querés automatizar con un solo comando.

Skills son formas de darle instrucciones detalladas sobre cosas puntuales al agente. Documentación específica que Claude puede consultar para tareas particulares.

Agentes son orquestradores de workflows complejos. Pueden llamar a otros agentes, coordinar tareas, y manejar flujos de trabajo elaborados.

Ejemplo: /explore

Un comando que uso constantemente es /explore. Cuando necesito entender o cargar en contexto algo en el codebase, corro (en ingles, pero para dar el ejemplo lo pongo en castellano):

/explore ¿Dónde se manejan los errores de autenticación?

o

/explore ¿Cómo funciona el sistema de caché?

El comando lanza un subagente que busca en el código, lee los archivos relevantes, y me devuelve un resumen de cómo está implementado.

Lo bueno es que consume menos contexto que si Claude principal hiciera toda la búsqueda. El agente explora, sintetiza, y devuelve solo lo importante. Esto es clave cuando trabajás con codebases grandes.

Skills en profundidad

Los skills son archivos markdown que le enseñan a Claude cómo hacer tareas específicas. A diferencia de los comandos que vos invocás explícitamente, los skills son invocados por el modelo.

Un skill se define en un archivo SKILL.md con metadata YAML y contenido markdown:

---
name: architecture-review
description: Revisa cambios de código para validar que respetan
  la arquitectura del proyecto. Usar cuando se hace code review
  o se evalúan cambios estructurales.
---

Cuando revises cambios de arquitectura:

1. Verificar que los módulos respetan las dependencias permitidas
2. Chequear que los datos fluyen en la dirección correcta
3. Validar que no se introducen dependencias circulares

¿Cuándo usar skills vs otras opciones?

• Skills: Conocimiento especializado que Claude aplica automáticamente cuando es relevante
• Comandos: Acciones que vos disparás explícitamente (/deploy, /test)
• CLAUDE.md: Instrucciones que se cargan en cada conversación
• Agentes: Workflows complejos que coordinan múltiples tareas

Ejemplos de skills útiles

Algunos skills que tengo configurados:

• commit-messages: Convenciones para mensajes de commit del proyecto
• error-handling: Patrones de manejo de errores específicos del proyecto
• testing-patterns: Cómo escribir tests siguiendo las convenciones del equipo

Lo clave es que la descripción sea clara y tenga palabras clave que Claude pueda matchear. Si la descripción es vaga, Claude no va a saber cuándo aplicarlo.

Yo suelo pedirle a Claude mismo que cree los skills, entablando una conversación para explicar lo que quiero y que me genere los SKILL.md automáticamente.

Para inspiración, hay varios repositorios con skills de la comunidad: anthropics/skills, awesome-claude-skills.

Paralelización con subagentes

Una de las cosas más poderosas de los agentes es que pueden lanzar otros agentes en paralelo usando la tool Task. Esto permite dividir trabajo grande en unidades independientes que se ejecutan al mismo tiempo.

Un ejemplo concreto: cuando corro linters como Pronto en Rails o clang-tidy en C++, a veces tengo decenas de errores en múltiples archivos. En lugar de arreglarlos uno por uno en forma serial, tengo un agente orquestrador que:

1. Lee la salida del linter
2. Agrupa los errores por archivo
3. Lanza un subagente por cada archivo para arreglar sus errores

Como cada archivo es una unidad de código disjunta, los agentes pueden trabajar en paralelo sin pisarse. Lo que antes tardaba varios minutos arreglándose archivo por archivo, ahora se resuelve en una fracción del tiempo.

La clave es identificar unidades de trabajo que sean independientes entre sí. Si un cambio necesita tocar multiples archivos que otros agentes también tienen que tocar, no conviene paralelizar. Pero para todo lo que sea paralelizable, usar Task es la que va.

Específicos, pero reutilizables

En general, los comandos, skills y agentes son súper específicos de cada proyecto. Es probable que cada codebase tenga sus propias convenciones, arquitectura y necesidades.

Pero cuando tenés proyectos similares, que usan los mismos frameworks, o incluso que miembros del equipo convergieron en algunos workflows o necesidades, podés empaquetarlos en plugins. Para mi experimento de desarrollo de juegos LLM-first definí un plugin de Claude Code que puedo usar en varios juegos en los que trabaje en un futuro.

Nota importante

Todo esto que cuento aplica a Claude Code, pero casi todos los agentes tienen features similares y sino se pueden desarrollar encima muy fácilmente. La idea de extender el agente con comandos, instrucciones específicas y subagentes no es exclusiva de esta herramienta.

Para los detalles de implementación específicos de Claude Code, recomiendo la documentación oficial. O simplemente pedirle a Claude Code que te lo haga 😉.

Lo que viene

Con comandos, skills y agentes configurados, tenés un sistema que puede hacer mucho trabajo por vos. Pero antes de mergear cualquier cambio, hay que asegurarse de que el código esté bien.

El code review es donde más valor le saco a los agentes. No solo para revisar mis propios cambios, sino para tener una segunda opinión automatizada que detecta cosas que a mí se me pasan.

En el próximo post voy a contar cómo armé un sistema de code review con múltiples agentes especializados que revisan performance, seguridad, estilo y arquitectura.