Recurso del reel «La Máquina» · @alexsepu_ · 15 sep 2026

Cómo crear tus agentes de IA

Los cinco agentes del reel, uno por uno: el que investiga, el que escribe, el que edita, el que arma el recurso y el que contesta los comentarios. Qué hace cada uno, con qué está hecho y cómo armas el tuyo.

Qué es un agente1 archivo texto plano, nada más
Para que funcione2 campos name y description
Lo que cuestaUS$17 al mes plan Pro, anual
Verificado15 sep 2026 en la doc oficial
La carpeta real de Alex · 15 sep 2026 14 archivos
$ cd ~/Documents/CODIGOS/SOTAI\ MAIN
$ ls .claude/agents/

analista-datos.md                   gestor-cuentas-ig.md
community-manager.md                media-buyer.md
copywriter.md                       productor-video-ia.md
disenador-carruseles.md             qa-marca.md
disenador-marca.md                  scraper-noticias.md
estratega-contenido.md              scraper-tendencias.md
estratega-ventas-infoproductos.md   storyteller.md

# 14 archivos de texto. Ninguno es una app. Ninguno se compró.
# Los 5 del reel:  scraper-noticias · storyteller · productor-video-ia
#                  disenador-carruseles · gestor-cuentas-ig

01 · Qué es, de verdad

Un agente es un archivo de texto con un jefe adentro

No es una app que se instala ni un robot que vive en un servidor. Es un archivo .md —el mismo formato de una nota— con dos partes: arriba una ficha de datos, abajo las instrucciones. Cuando le pides algo a la IA que encaja con la ficha, la IA se lo pasa a ese archivo y trabaja con esas instrucciones y nada más.

Su propia mesa

Trabaja aparte

Cada agente corre en su propia ventana de contexto. Lo que revuelva investigando no te ensucia la conversación principal: te regresa sólo el resultado.

Sus propias llaves

Sólo las herramientas que le des

En la ficha decides qué puede tocar: leer, buscar en internet, escribir archivos, correr comandos. Lo que no le escribiste, no lo tiene.

Se llama solo

La descripción es el disparador

No hay botón. La IA lee la descripción de cada agente y decide cuál encaja con lo que pediste. Una descripción floja es un agente que nunca entra.

«Los subagentes son asistentes de IA especializados que se encargan de tipos de tarea específicos… cada subagente corre en su propia ventana de contexto, con su propio prompt de sistema, su acceso a herramientas y sus permisos.»

Documentación oficial de Claude Code · «Create custom subagents» · leída el 15 sep 2026 · traducción nuestra
code.claude.com/docs/en/sub-agents
Página oficial de Claude Code, Create custom subagents
La página oficial, sin iniciar sesión, el 15 sep 2026. Es la única fuente de esta sección.

02 · La letra chica, antes de instalar nada

Qué necesitas y cuánto cuesta

Esto se hace con Claude Code, la versión de Claude que corre en la terminal de tu computadora. Es la que usa Alex y la que documentamos aquí. Tres datos antes de que gastes un peso.

$0Plan FreeNo incluye Claude Code
$17Plan Pro, al mes con suscripción anual (US$200 por adelantado). US$20 si lo pagas mes a mes.Sí incluye Claude Code
Desde $100Plan Max, al mesSí incluye Claude Code
claude.com/pricing · planes individuales
Página de precios de Claude: Free 0 dólares, Pro 17 dólares, Max desde 100 dólares
Precios leídos en claude.com/pricing el 15 sep 2026, en dólares. No hay precio en pesos publicado.

Instalarlo son dos líneas

Mac, Linux o WSL · pégalo en la Terminal
curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude

En Windows PowerShell la primera línea es irm https://claude.ai/install.ps1 | iex. La segunda tiene que responder un número seguido de «(Claude Code)». La tercera abre la sesión y te pide entrar con tu cuenta.

Dónde viven los agentes

Dos carpetas, y la diferencia importa: una es del proyecto, la otra es tuya para todos tus proyectos. Si el mismo nombre existe en las dos, gana la del proyecto.

CarpetaAlcancePrioridadPara qué la quieres
.claude/agents/Sólo este proyecto3El equipo de este negocio o este cliente. Es la que usa Alex.
~/.claude/agents/Todos tus proyectos4Los tuyos de siempre, los que quieres en cualquier carpeta.
code.claude.com/docs/en/sub-agents · dónde viven
Tabla oficial con las cinco ubicaciones de los subagentes y su prioridad
La tabla completa de las 5 ubicaciones, con las otras tres (organización, bandera de sesión y plugins), el 15 sep 2026.

Lo que nadie te dice: un agente no se despierta solo. No hay reloj, no hay servidor, no hay cron. Existe cuando tú abres la sesión y le pides algo —o cuando la IA decide que su descripción encaja. Los cinco del reel se invocan a mano, todos los días. Si quieres que corran a una hora, eso es otra cosa y la montas aparte.

03 · Cómo se hace

Tu primer agente, en seis pasos

El ejemplo es el más útil para cualquier negocio: un agente que revisa cada mañana lo que se dice de tu sector y te deja el reporte escrito. Cámbiale el tema y es el tuyo.

  1. Abre la terminal en la carpeta de tu negocio

    Una carpeta cualquiera donde vivan tus cosas: tus documentos, tus notas, tu catálogo. Ahí adentro escribes claude y ya estás dentro de la sesión.

  2. Pídele a Claude que escriba el agente

    Desde la versión 2.1.198 el comando /agents ya no abre un asistente con pasitos: se lo pides con palabras y él escribe el archivo. Copia el prompt de abajo, cámbiale los corchetes y mándalo tal cual.

  3. Abre el archivo y léelo

    Te va a quedar en .claude/agents/vigia-de-mercado.md. Ábrelo. Aquí es donde la mayoría se detiene y por eso su agente sale genérico: ese texto es el agente. Si dice cosas vagas, va a hacer cosas vagas.

  4. Dale contexto real, no adjetivos

    Los cinco agentes de Alex empiezan igual: con una lista de archivos que tienen que leer antes de hacer nada. Haz lo mismo. Nombres de tus competidores, tus precios, cómo hablas, qué NO quieres. Un agente con tus datos vale diez veces uno con instrucciones bonitas.

  5. Invócalo y míralo trabajar

    Con palabras («usa el agente vigia-de-mercado para el reporte de hoy») o a la segura con @agent-vigia-de-mercado. La arroba garantiza que entre; el lenguaje natural depende de que la descripción esté bien escrita.

  6. Corrígelo el mismo día

    Lo que te entregó mal, escríbelo como regla en su archivo. Claude Code vigila esas carpetas: al guardar, la siguiente vez ya usa la versión nueva, sin reiniciar nada. Un agente bueno es un archivo que lleva veinte correcciones encima.

Paso 2 · pégaselo a Claude Code con tus datos ~930 caracteres
Créame un agente en .claude/agents/ que se llame vigia-de-mercado.

Lo que quiero que haga, cada vez que lo invoque:
1. Buscar en internet lo que se publicó en los últimos 3 días sobre [TU SECTOR]
   en [TU CIUDAD O PAÍS], y lo que publicaron estas cuentas o sitios:
   [COMPETIDOR 1], [COMPETIDOR 2], [COMPETIDOR 3].
2. Descartar todo lo que no le sirva a [TU CLIENTE IDEAL, EJ. "dueños de taller
   mecánico que no saben de tecnología"]. Prefiero 3 hallazgos útiles que 20.
3. Clasificar cada hallazgo en URGENTE (me conviene hablar de esto hoy) o
   SEGUIMIENTO (guardarlo para la semana).
4. De cada hallazgo escribir: resumen en 2 líneas, la liga de la fuente, y qué
   haría yo con eso. Si un dato no lo puede verificar en la fuente, NO lo pone.
5. Guardar todo en reportes/AAAA-MM-DD-mercado.md, un archivo por día.

En la ficha del agente:
- description: que sea clara para que se invoque solo cuando yo pida el reporte
  del día, la revisión de competencia o de qué hablar hoy.
- tools: dale sólo Read, Glob, Grep, Write, Edit, WebSearch y WebFetch.
  No quiero que corra comandos.

Antes de escribirlo, dime en una línea qué vas a poner en description y por qué.
Así se ve por dentro · la plantilla en blanco
---
name: vigia-de-mercado
description: Se invoca para el reporte diario de lo que publicó la competencia y
  las noticias del sector que conviene aprovechar hoy.
tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch
model: sonnet
---

# Vigía de Mercado

## Primer paso siempre: leer contexto
- negocio/clientes.md — a quién le vendo y qué le importa
- negocio/competencia.md — las cuentas y sitios que vigilo
- negocio/tono.md — cómo hablo y qué palabras no uso

## Proceso
1. …
2. …

## Lo que NUNCA hace
- Inventar una cifra que no esté en la fuente.
- Reportar dos veces la misma noticia.

Arriba, entre las dos líneas de guiones, la ficha. Abajo, las instrucciones: ese texto es literalmente lo que el agente lee antes de trabajar. Nada más. Ni tu conversación, ni el resto del proyecto.

04 · Los cinco del reel

Los archivos reales, tal como están hoy

Lo que sigue no es un ejemplo: es el contenido literal de la ficha de cada uno de los cinco agentes que salen en el video, copiado de la carpeta de Alex el 15 de septiembre de 2026. Debajo de cada uno, el prompt que te arma el equivalente para tu negocio.

01El que investiga

7 herramientasscraper-noticias.md

«Este agente se encarga de buscar en internet y organizarme toda la información de inteligencia artificial que sea relevante y lo que ha hecho mi competencia, para ver de qué vale la pena hablar hoy.»

Qué hace
  1. Revisa 12 fuentes ya aprobadas, tres por región, en vez de buscar a ciegas
  2. Filtra contra un archivo con quién es la audiencia
  3. Marca cada hallazgo 🔴 urgente o 🟡 seguimiento
  4. Escribe un archivo por día y no repite lo de ayer
Con qué está hecho

Claude Code y nada más. Es el más simple de los cinco: 36 líneas. Lo que lo hace bueno no es la herramienta, es que la lista de fuentes ya está decidida y escrita adentro.

El atorón

Si no le escribes a quién le hablas, te trae noticias corporativas que a nadie le importan. El filtro de audiencia va antes que la búsqueda, no después.

La ficha real · .claude/agents/scraper-noticias.md literal
---
name: scraper-noticias
description: Se invoca para monitorear noticias y lanzamientos de IA relevantes que
  requieren publicación casi en tiempo real, fuera del colchón editorial normal.
tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch
---

Tu versión: el prompt del paso 2 crea exactamente este agente para tu sector.

02El que escribe

627 líneasstoryteller.md

«Este agente conoce todos los videos que yo subí a internet, así que conoce exactamente la manera de comunicar que me gusta, dándome guiones totalmente a mi estilo.»

Qué hace
  1. Lee primero los guiones anteriores y el calendario del día
  2. Escribe con un método propio de 5 formatos (reel, demo de pantalla, faceless, outline de YouTube…)
  3. Tiene una sección entera de cómo calibrar el gancho
  4. Y otra de qué CTA nunca pedir
Con qué está hecho

Claude Code. Es el archivo más largo de los cinco, 59 KB. No porque sea complicado: porque ahí adentro está guardado, regla por regla, cada corrección que Alex le hizo en cinco meses.

El atorón

«Escribe con mi tono» no significa nada. Lo que sí funciona: pegarle diez guiones tuyos que sí jalaron y una lista de palabras que jamás usas. El estilo se enseña con ejemplos, no con adjetivos.

La ficha real · .claude/agents/storyteller.md literal
---
name: storyteller
description: Se invoca para escribir los guiones que Alex graba — guiones cortos para
  Reels/TikTok/IG, demos de pantalla paso a paso ("¿qué pasa si le pides a la IA
  que...?"), guiones faceless narrados con voz IA para Sotai, y outlines de tutoriales
  largos de YouTube — a partir del calendario editorial y el pilar de contenido del día.
tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch
---
El tuyo · pégaselo a Claude Code ~720 caracteres
Créame un agente .claude/agents/guionista.md que escriba los guiones que yo grabo.

Antes de escribir nada, siempre tiene que leer:
- voz/guiones-que-funcionaron.md (te lo voy a llenar con 10 guiones míos)
- voz/prohibido.md (palabras y frases que yo nunca digo)
- negocio/clientes.md (a quién le hablo)

Reglas del guion:
- Español de [TU PAÍS], como se habla, no como se escribe. Frases cortas.
- Gancho de máximo 10 palabras, sin CTA en la primera línea.
- Duración objetivo [30 / 45 / 60] segundos.
- Cierra con: "[TU CTA]".
- Si le falta un dato real (precio, fecha, nombre), me lo pregunta. No lo inventa.

Que entregue 3 versiones distintas del gancho y una sola del cuerpo.
tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch

03El que edita

Necesita más que Claudeproductor-video-ia.md

«Mi tercer agente se encarga de editar el video, como este que estás viendo. Simplemente le doy los materiales en crudo y él se encarga de lo demás.»

Qué hace
  1. Transcribe la grabación palabra por palabra, con su tiempo
  2. Arma la edición sobre esos tiempos: subtítulos, capas, efectos
  3. Mezcla voz, música y sonidos, y los nivela
  4. Renderiza el archivo final que se sube
Con qué está hecho

Claude Code + HyperFrames + ElevenLabs. Es el único de los cinco que necesita permiso para correr comandos en la computadora (Bash), porque tiene que renderizar video de verdad.

Y sí: este reel lo editó él.

El atorón

Es el más caro de montar y el que menos se parece a «pídeselo y ya». Si vas empezando, no arranques por aquí: monta los agentes 1 y 2, que son texto puro, y deja este para cuando ya tengas ritmo.

La ficha real · .claude/agents/productor-video-ia.md literal
---
name: productor-video-ia
description: Se invoca para la post-producción de video corto — edita el material real
  grabado por Alex (marca personal, rig de 3 planos) y produce el contenido faceless de
  Sotai — sobre HyperFrames, aplicando el códice de 08 Motor de Video/motor/. Voz por
  ElevenLabs (Juniper); Higgsfield sólo para assets visuales que no se puedan capturar.
tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch, Bash
---

Fíjate en el Bash al final: es el único de los cinco que lo trae. Ese campo no es decoración, es un permiso.

04El que arma el recurso

Esta páginadisenador-carruseles.md

«El cuarto agente se encarga de revisar el video y crear los recursos, todos estos materiales que te envío cada que comentas

Qué hace
  1. Construye el material que se entrega: carruseles y guías como esta
  2. Trabaja con HTML y capturas reales, no con plantillas de banco
  3. Tiene escrito que los materiales se buscan antes de generarlos
Con qué está hecho

Claude Code + Playwright (el que toma las capturas de pantalla solo). Esta página se armó con ese mismo método: las tres capturas de la documentación y la de precios se tomaron hoy con Playwright, sin sesión.

Lo que declaramos

En el video Alex dice «revisar el video y crear los recursos». En la carpeta real no hay un agente que haga las dos cosas: este arma el recurso y la revisión la hace otro. Un trabajo por agente funciona mejor que uno que haga dos.

La ficha real · .claude/agents/disenador-carruseles.md literal
---
name: disenador-carruseles
description: Se invoca para diseñar carruseles de Instagram, tanto para la cuenta
  personal de Alex Sepúlveda como para la cuenta de Sotai.
tools: Read, Glob, Grep, Write, Edit, WebSearch, WebFetch, Bash
---

05El que contesta

Hereda todogestor-cuentas-ig.md

«El quinto es el encargado de revisar los comentarios. Cada que alguien comente la palabra clave, él se encarga de enviarle su recurso al DM de cada uno.»

Qué hace
  1. Publica el reel en las dos cuentas por la API de Instagram
  2. Da la primera línea de respuesta en comentarios y DMs
  3. Deja escrita la regla: palabra clave → este link
Con qué está hecho

Claude Code + la API de Instagram + n8n. El agente deja la regla escrita; quien la ejecuta cuando alguien comenta es una automatización aparte, corriendo todo el día. Por ahí te llegó este link.

El atorón que cuesta semanas

Meta sólo manda el aviso de un comentario nuevo si tu Página tiene suscrito el evento comments. Si no lo está, no hay ningún error en ninguna parte: los comentarios entran y no pasa nada. Revísalo antes de culpar a tu automatización.

La ficha real · .claude/agents/gestor-cuentas-ig.md literal
---
name: gestor-cuentas-ig
description: Se invoca para publicar y curar contenido en las dos cuentas de Instagram
  (Alex Sepúlveda y Sotai) de forma coordinada, y para dar primera línea de respuesta
  en ambos canales.
---

Este no trae tools. Cuando omites ese campo, el agente hereda todas las herramientas disponibles. Es cómodo y es justo lo que no debes hacer con un agente que toca tus cuentas: dale sólo lo que necesita.

La regla que te mandó esta guía escucha IA o AI en los comentarios de este reel, y pide seguir la cuenta antes de mandar nada.

Los otros nueve

En la carpeta hay 14, no 5: estratega de contenido, copywriter, analista de datos, QA de marca, media buyer y otros. No todos están afinados —varios son esqueletos esperando su turno— y eso también es honesto: un equipo de agentes se construye uno a la vez, cuando una tarea empieza a repetirse. Empezar con los 14 el primer día es la forma más rápida de no usar ninguno.

05 · La ficha, campo por campo

Dos campos obligatorios. El resto es control.

Todo lo que va entre las dos líneas de guiones. Sólo los dos primeros son obligatorios; los demás sirven para que el agente haga menos de lo que podría, que casi siempre es lo que quieres.

CampoQué haceCuándo lo usas
nameEl nombre. Minúsculas y guiones, sin dos puntos.Obligatorio Siempre. Es con el que lo llamas.
descriptionCuándo hay que delegarle a él. Es lo que lee la IA para decidir.Obligatorio Siempre. Escríbelo como si le explicaras a un asistente nuevo en qué casos entra.
toolsLa lista de lo que puede tocar. Si lo omites, hereda todo.Casi siempre. Es el freno de mano.
disallowedToolsAl revés: quítale cosas de lo que heredó.Cuando quieres «todo menos escribir».
modelQué modelo usa: sonnet, opus, haiku, fable, o inherit.Un agente que sólo ordena datos no necesita el modelo más caro.
permissionModeCuánto te pregunta antes de actuar.Cuando el agente toca archivos de verdad.
maxTurnsCuántas vueltas puede dar antes de parar.Para que un agente que se atora no siga solo.
memoryMemoria que se guarda entre sesiones.Cuando lo que aprendió ayer sirve hoy.
colorEl color con el que aparece.Puro gusto. Ayuda cuando ya tienes varios.
code.claude.com/docs/en/sub-agents · la ficha
Ejemplo oficial de un archivo de subagente con name, description, tools y model
El ejemplo oficial, el 15 sep 2026. Abajo dice la frase que más te conviene entender: el cuerpo del archivo es el prompt de sistema del agente, y eso es todo lo que recibe.

La frase que lo explica todo: «los subagentes reciben únicamente este prompt de sistema, más detalles básicos del entorno». Ni tu conversación, ni lo que le dijiste a Claude hace diez minutos. Por eso los cinco agentes de Alex empiezan con una lista de archivos que tienen que leer: si el contexto no está escrito, para el agente no existe.

06 · Cuando se atora

Los seis atorones de siempre, con su arreglo

«Lo creé y nunca se usa»

Arreglo: el 90% de las veces es la description. La IA sólo delega si lo que pediste encaja con lo que ahí dice. Escríbela en términos de la petición del usuario («se invoca cuando pido el reporte del día o la revisión de competencia»), no del oficio del agente («experto en investigación»). Y si quieres garantizarlo, llámalo con @agent-nombre: así entra a fuerza.

«Hace cosas que yo no le pedí»

Arreglo: si tu archivo no trae tools, el agente heredó todas las herramientas disponibles, incluida la de correr comandos. Ponle la lista corta de lo que sí necesita, o quítale lo peligroso con disallowedTools.

«Le hablo de mi negocio y no sabe nada»

Arreglo: no es olvido, es diseño. El agente recibe su archivo y nada más —ni tu conversación, ni el resto del proyecto. Escribe el contexto en archivos y ponlos en su primera instrucción: «antes de hacer nada, lee estos tres archivos».

«Guardé el archivo y Claude sigue usando la versión vieja»

Arreglo: normalmente no hace falta reiniciar, Claude Code vigila esas carpetas y recoge el cambio en segundos. La excepción: si acabas de crear la carpeta agents durante la sesión, reinicia una vez y ya.

«Tengo dos agentes que se llaman igual»

Arreglo: gana el de la ubicación de mayor prioridad —el del proyecto le gana al tuyo personal—. Si los dos están en la misma carpeta, carga uno al azar. Corre /doctor: te dice cuáles están duplicados.

«Hice veinte agentes y ahora todo va raro»

Arreglo: todas las descripciones juntas se cargan siempre; pasando de 15,000 tokens sale un aviso. Menos agentes, descripciones de dos renglones. Un agente por tarea que se repite de verdad, no por tarea que imaginas.

07 · El filtro

Esto no es para todo el mundo

Empieza hoy

Te conviene si…

  • Hay una tarea que repites cada semana y siempre le explicas lo mismo a la IA.
  • Puedes escribir en archivos lo que sabes: tus clientes, tus precios, tu forma de hablar.
  • Vas a corregir el archivo cada vez que te entregue algo mal, en lugar de rendirte.
  • Vas a empezar con uno, no con cinco.
Todavía no

Espérate si…

  • Esperas que trabajen solos mientras duermes: no se despiertan si tú no abres la sesión.
  • Todavía no tienes ninguna tarea que se repita. Un agente para algo que hiciste una vez es puro trabajo extra.
  • No piensas revisar lo que entregan antes de publicarlo.
  • Lo que necesitas es que tus sistemas se hablen entre ellos solos —WhatsApp, tu correo, tu inventario—: eso ya es una automatización a la medida, no un agente.

08 · Fuentes y método

De dónde salió cada dato

Todas consultadas el 15 de septiembre de 2026, sin iniciar sesión en ningún servicio.

  • Anthropic — Create custom subagents: dónde viven los archivos y con qué prioridad, los campos de la ficha, cómo se delega y cómo se heredan las herramientas.code.claude.com · sub-agents
  • Anthropic — Quickstart de Claude Code: los comandos de instalación, el primer inicio de sesión y qué cuentas sirven.code.claude.com · quickstart
  • Anthropic — Precios: Free US$0 (sin Claude Code), Pro US$17 al mes con pago anual o US$20 mensual, Max desde US$100.claude.com/pricing
  • Anthropic — Modos de permiso: qué decide cuánto te pregunta antes de tocar un archivo.code.claude.com · permission-modes

Nota de método. Las fichas de los cinco agentes son copias literales de los archivos de .claude/agents/ en la computadora de Alex, tomadas el 15 sep 2026: no se reescribieron ni se embellecieron, y por eso algunas están en español y otras mezclan términos en inglés. El conteo de 14 archivos y los tamaños salen de esa misma carpeta. Las tres capturas de la documentación y la de precios son nuestras, tomadas sin sesión el 15 sep 2026, sin retoque; el marco de navegador es diseño nuestro. Los prompts de esta guía son nuestros, escritos siguiendo lo que la documentación dice que cada campo hace; no se corrieron uno por uno en una cuenta ajena. Lo del evento comments de Meta no sale de la documentación: es algo que medimos en nuestra propia cuenta después de semanas de creer que la automatización estaba rota. Sotai no está afiliada a Anthropic, y nadie pagó por aparecer aquí. Claude Code cambia seguido: si algo no te cuadra, la página oficial manda sobre esta guía.

Y cuando un agente ya no alcance

Un agente te ahorra la tarde. Que los cinco se pasen el trabajo entre ellos te ahorra el mes.

Todo lo de esta guía lo puedes montar tú, esta semana, con un plan de US$17. Empieza por uno, el de la tarea que más repites, y córrelo diez días seguidos.

Si después te das cuenta de que lo que falta no es otro agente sino que las piezas se hablen entre sí —tu WhatsApp, tu correo, tu inventario, tus clientes— y que eso corra sin que tú abras nada, ahí entramos nosotros. En Sotai montamos ese sistema sobre tu operación real, con tus datos, y lo dejamos funcionando. Cuéntanos por DM qué tarea te come las horas: te decimos si se automatiza hoy o todavía no.

SOTAI
Alex Sepúlveda · 15 de septiembre de 2026