01 Lo que ha medido Anthropic
El consejo habitual es montar un «equipo»: un agente que planifica, otro que programa y otro que revisa. Anthropic ha publicado dos artículos que matizan mucho esa idea. En Building multi-agent systems: when and how to use them explica que dividir el trabajo por tipo de tarea genera una sobrecarga de coordinación constante y que, en sus pruebas, los sistemas multiagente suelen gastar de 3 a 10 veces más tokens que un solo agente para la misma tarea.
En The anatomy of effective commerce agents, con un apartado titulado «Skills, not subagents», cuenta que en varios despliegues empresariales un único agente con skills superó de forma consistente tanto al diseño de un solo prompt gigante como al de subagentes, en calidad y a menudo en coste y latencia. El motivo: cada traspaso a un subagente pierde estado; el que recibe la tarea solo ve un resumen.
| Varios agentes | Un agente con skills | |
|---|---|---|
| Contexto | Cada uno empieza de cero y recibe un resumen | Uno solo conserva toda la sesión |
| Conocimiento | Repartido en varios prompts | En archivos de una carpeta; se corrige en un sitio |
| Coste | Contexto duplicado y mensajes de coordinación | Solo el texto de la skill que se usa, cuando se usa |
| Errores | Difícil saber qué agente falló | Un único lugar donde mirar |
02 La carpeta del agente
Tu agente es una carpeta de trabajo con archivos de texto que Claude Code lee al arrancar o cuando los necesita. Ábrelo siempre dentro de la carpeta donde están tus documentos reales, no en una carpeta vacía de pruebas.
mi-trabajo/
├── CLAUDE.md # quién es y cómo trabaja (se carga siempre)
├── ejemplos/ # pares de entrada y salida bien resueltos
├── .claude/
│ ├── skills/
│ │ ├── presupuestos/SKILL.md
│ │ └── informe-mensual/SKILL.md
│ └── settings.json # permisos y hooks
└── .mcp.json # conexiones a tus sistemas (opcional)CLAUDE.md
Se carga en cada sesión. Contexto del negocio, tono, normas y dónde está cada cosa. Mantenlo por debajo de unas 200 líneas.
Skills
Solo su descripción está siempre presente; el contenido se carga cuando la tarea encaja. Así puedes tener muchas sin pagar su coste a diario.
Ejemplos
Casos reales resueltos como a ti te gusta. Es lo que más mejora el resultado y lo que casi nadie aporta.
Hooks y MCP
MCP da acceso a tus sistemas; los hooks imponen reglas que el modelo no puede saltarse.
03 Paso 1: que te entreviste antes de escribir
cd "/ruta/a/tu/carpeta" && claudeEl comando /init genera un CLAUDE.md analizando código. Si tu carpeta son presupuestos, contratos o notas de clientes, sacarás más con una entrevista: le cuentas el oficio como a alguien que empieza el lunes.
Quiero convertir esta carpeta en mi agente de trabajo. Antes de escribir ningún archivo, entrevístame: una pregunta cada vez, y si mi respuesta es vaga, repregunta hasta tener un ejemplo concreto. Puedes abrir los documentos de la carpeta para ver cómo trabajo.
Cubre: a qué me dedico y para quién; las tres tareas que más repito; cómo sé que una entrega está bien; qué errores no puedo permitirme; qué tono uso con clientes; dónde guardo cada tipo de documento.
Cuando termines, propón un CLAUDE.md de menos de 120 líneas y una lista de skills candidatas (nombre y descripción de una línea). No guardes nada hasta que lo apruebe.04 Paso 2: convierte tareas repetidas en skills
Una skill es un archivo SKILL.md dentro de .claude/skills/<nombre>/, con un frontmatter que incluye name y description. La descripción decide cuándo se activa, así que escríbela con las frases que usas de verdad. El nombre de la carpeta también se convierte en comando: /presupuestos.
Regla práctica para decidir: si una instrucción aplica a casi todo, va en el CLAUDE.md; si solo aplica a un tipo de tarea, va en una skill. Y crea una skill nueva cuando algo te haya salido mal dos veces, no antes.
---
name: presupuestos
description: Prepara presupuestos de proyectos web a partir de una petición de cliente. Úsala cuando pida un presupuesto, una estimación o «cuánto costaría».
---
1. Lee la petición y localiza al cliente en clientes/.
2. Usa la tarifa de tarifas.md; no inventes precios.
3. Desglosa por fases con horas y precio.
4. Compara el resultado con los ejemplos de ejemplos/presupuestos/.
5. Entrega un borrador en presupuestos/borradores/ y enumera los supuestos.05 Paso 3: ejemplos y un bucle de verificación
Describir lo que quieres funciona; enseñarlo funciona mucho mejor. Guarda en ejemplos/ pares de entrada y salida: la petición original de un cliente y la respuesta que mandaste y funcionó. Tres o cuatro por tarea suelen bastar.
Después, dale una forma de comprobar su propio trabajo con un resultado claro de «pasa» o «no pasa»: una lista de verificación, un script que valide formato o importes, o una comparación con el ejemplo. Sin eso, el bucle de verificación eres tú.
Revisa la skill [nombre] y añádele un paso final de verificación. Debe comprobar, con resultado pasa o no pasa, al menos: [criterio 1], [criterio 2] y [criterio 3]. Si algo no pasa, corrige y vuelve a comprobar como máximo dos veces; si sigue fallando, detente y explícame qué falla. Enséñame el cambio antes de guardarlo.06 Paso 4: conexiones y reglas que obligan
Para que el agente trabaje con tus sistemas (CRM, correo, base de datos) conéctalos mediante servidores MCP. Y recuerda que el CLAUDE.md es contexto: escribir «NUNCA borres» en mayúsculas ayuda, pero no garantiza nada. Lo que de verdad impide una acción son los permisos y los hooks: por ejemplo, un hook PreToolUse puede bloquear la edición de archivos protegidos, devolviendo a Claude el motivo para que cambie de enfoque.
- ✓Conecta solo los sistemas que la tarea necesita y con el mínimo permiso.
- ✓Protege con hooks o permisos los archivos que nunca deben tocarse (contratos firmados, .env, facturas emitidas).
- ✓Exige confirmación antes de enviar correos, publicar o mover dinero.
- ✓Revisa /context de vez en cuando para ver cuánto ocupa cada pieza cargada.
07 Cuándo sí partirlo en varios agentes
| Situación | Ejemplo | Qué hacer |
|---|---|---|
| Contexto contaminado | Revisar 200 documentos para extraer solo cinco datos | Un subagente que filtra y devuelve el resultado limpio |
| Trabajo paralelo | Investigar diez competidores a la vez | Varios subagentes en paralelo y uno que consolida |
| Herramientas muy distintas | Una parte usa navegador y otra contabilidad | Separar por herramientas, no por tipo de trabajo |
Ten en cuenta que Claude Code ya usa subagentes integrados por su cuenta, por ejemplo para explorar el código. No necesitas montar un organigrama: añade complejidad solo cuando tengas pruebas de que mejora el resultado.
Preguntas frecuentes
No. Sirven en casos concretos: aislar información que contamina el contexto, paralelizar tareas independientes o separar herramientas. Lo que Anthropic desaconseja es repartir una misma tarea por tipo de trabajo.
Solo se carga siempre su descripción; el contenido entra cuando se usa. Aun así, descripciones vagas o solapadas provocan activaciones erróneas, así que mantén pocas y bien definidas.
No. Claude Code requiere un plan Pro, Max, Team o Enterprise.
Cowork carga las skills activadas en tu cuenta de claude.ai, no las de la carpeta personal ~/.claude/skills de tu ordenador. Para usarlas allí, súbelas desde la sección de skills de tu cuenta.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.