Claude Code Club · Cuaderno de estudio
Etapa 7 — Agents

🛠️ Construye tu primer agente de principio a fin

Lo que te llevarás: un agente real y funcional guardado en tu proyecto — invocable en cualquier momento con un comando, y que redacta contenido con tu voz real.

Infografía: descríbelo y se construye en vivo
El objetivo del tutorial: daily-content-draft — de una idea en bruto a 3 borradores con tu voz, sin publicar nada.

Deja de leer: se construye uno. Objetivo: daily-content-draft — un agente que, bajo comando, redacta 3 opciones de post con tu voz a partir de una idea en bruto, las deja como archivos de texto en una carpeta, y nunca publica nada.

Los 5 pasos del tutorial

  1. Crea la carpeta y el archivo. Pide a Claude Code que cree el archivo del agente en la ruta canónica: .claude/agents/daily-content-draft.md. Claude Code mira ahí automáticamente — los agentes de proyecto y de usuario viven en .claude/agents/, y los de proyecto tienen prioridad si algún día sobrescribes uno.
  2. Escribe el archivo en lenguaje llano, siguiendo la receta de 5 partes de la lección anterior: una cabecera con name, description y tools: Read, Write; un bloque SOUL (tu ghostwriter: 4-6 frases describiendo tu voz de verdad — ¿frases cortas o largas? ¿emojis? ¿historias o frameworks? — y las palabras que jamás usaría); un bloque JOB (exactamente 3 opciones de post: gancho corto <280 caracteres, historia media de 3 párrafos, y versión larga de enseñanza); y la condición de parada (guardar en /drafts/…, nunca publicar). La plantilla completa para pegar está en la lección de Skool.
  3. Acota sus herramientas (las llaves). La línea tools: Read, Write es el cinturón: sin Bash, sin internet, sin nada destructivo. Por defecto las mínimas herramientas que hagan el trabajo, y añade una solo si de verdad la necesitas. Un agente de redacción nunca necesita Bash; uno de investigación nunca necesita Write.
  4. Dispara la primera ejecución. «Usa el agente daily-content-draft con esta idea: "[tu idea en bruto]"». Claude coge el archivo, asume su SOUL, ejecuta el JOB y para en la condición de parada. Mírala entera, sin multitarea — la primera ejecución es la que te enseña qué escribiste mal en el archivo.
  5. Lee el resultado y ajusta EL ARCHIVO (no el prompt). Lee los 3 borradores en voz alta — el oído pilla problemas de voz que el ojo no ve. Si la voz falla, edita la sección SOUL del archivo del agente, no el prompt que tecleaste.

🔧 Arregla el agente, no la petición. Cada arreglo al archivo es permanente; cada arreglo al prompt se evapora al cerrar la sesión. Ese es el bucle completo.

🔁 Ejecútalo dos veces más con dos ideas distintas. A la tercera, la voz debería ser inquietantemente parecida a la tuya. Si no lo es, tu SOUL es demasiado corto — añade 2 líneas más y un post de ejemplo.
Fuente: Claude Code Club · Aula · Etapa 7 «Agents» — lección «Construye tu primer agente de principio a fin».
Nota: resumen del tutorial; la plantilla íntegra del archivo y los prompts exactos están en la lección original. · Añadido: 7 de julio de 2026.