🛠️ Cómo crear una Skill y un Agente
El system prompt fue solo el comienzo. Ahora subes un nivel: vas a empaquetar una habilidad en una Skill (que se activa por sí sola con la description) y, cuando el trabajo lo requiera, va "contratar" a un agente con un principio y un final bien definidos. Veamos las cinco capas del sistema agéntico, dónde encaja cada pieza y cuándo conviene paralelizar — con un ejemplo real de INEMA al final.
Contenido detallado
Qué es una Skill
Hasta aquí escribiste un prompt para usar ahora, en la mano. Una Skill es el paso siguiente: empaquetas una habilidad —"crear un video", "armar un cómic", "analizar un flujo"— de modo que la IA la active por sí sola cuando la solicitud encaja. No pegas el prompt cada vez; la habilidad queda guardada y aparece en el momento adecuado. El secreto de una buena skill está en solo dos partes.
🧩 Una skill son dos cosas unidas
Toda skill tiene una description (la etiqueta que decide cuándo ella conecta) y un cuerpo de instrucciones (qué hacer después que conectó). La descripción es la parte que la IA lee todo el tiempo para decidir si esa solicitud "corresponde" a esa skill. El cuerpo solo se lee cuando se activa.
Por eso la regla de oro: la description es la parte más importante. Una instrucción impecable que nunca se activa no sirve para nada. Escribe la etiqueta con activadores claros: las palabras reales que usaría el usuario.
Qué es
Un paquetito con un nombre, una description rica en activadores, y un cuerpo de instrucciones (un SKILL.md) que enseña a la IA a ejecutar esa tarea de principio a fin. Es como darle a la IA una "receta grabada": reconoce la solicitud por la etiqueta y sigue los pasos sin que tengas que volver a explicarlo todo.
Por qué importa
Porque una skill convierte un prompt que pegas cada vez en una capacidad que habita en tu sistema. Y porque el principal punto de falla es el activador: las skills que "no se activan" casi siempre tienen una descripción vaga. Acertar con la etiqueta es lo que separa una skill útil de una que duerme para siempre.
name: video-explicativo description: Cria vídeos explicativos em PT-BR a partir de um assunto — roteiro, narração, cenas animadas e CTA. Use quando o usuário pedir "fazer um vídeo", "vídeo explicativo", "vídeo sobre X", "vídeo pra Shorts/Reels", "mini tutorial em vídeo", ou quando der um assunto e quiser um vídeo narrado pronto. Cobre roteiro, locução, animação, render e a CTA final.
Observa: la description dice lo que hace y, sobre todo, cuándo usar — con las frases exactas que activan la skill entre comillas. Eso es lo que hace que la skill se active con la solicitud correcta (y se quede quieta con las demás).
Las 5 capas de un sistema agéntico
Una skill no existe por sí sola. Es una pieza de un todo más grande — lo que la gente llama Agentic OSun sistema operativo agéntico, ensamblado por capas. Mira la pila de arriba: cinco niveles, de la base a la cima, cada uno apoyado en el de abajo. Conocer esa pila es saber dónde vivirá cada cosa que creas.
1. Identidad — los cimientos
La base de todo. Sin ella, todas las capas superiores quedan «directionally fluffy».
Quién es el sistema, los datos que lo conectan con la realidad y los objetivos. En el ejemplo de salud del video fuente, es el panel de ADN, los marcadores, las metas. "Si los datos no están organizados, construyes algo bonito que quizá ayude, pero no está hecho a tu medida."
2. Reglas y Hooks — los rieles
Lo que siempre se mantiene, más las automatizaciones que se activan ante eventos.
Reglas son el comportamiento estable («la verdad por encima de la adulación»). Hooks son activadores automáticos que el harness fuerza en ciertos momentos — ej.: «después de editar un archivo, ejecuta las pruebas». La regla pide; el hook garantiza.
3. Skills — las habilidades
La capa intermedia: recetas que se activan mediante la description.
Habilidades empaquetadas que el sistema activa cuando la solicitud coincide — análisis de dieta, resumen de la semana, extracción de informe. Es exactamente lo que viste en el tema 1: description que conecta + cuerpo que ejecuta.
4. Agentes y subagentes: los roles
Trabajadores con un papel, un inicio y un final definidos.
Un agente tiene un papel propio (p. ej.: "un coach general que lee mis marcadores antes de responder"); subagentes son especialistas a quienes llama (metabolismo, entrenamiento, suplementación). Esta es la capa donde más gente «se adelanta» — volvemos a ella en el tema 4.
5. Herramientas · MCPs · CLIs: las manos
La cima: lo que realmente afecta al mundo.
Buscar en la web, ejecutar código, guardar en una base de datos (en el ejemplo, un Supabase con 13 tablas), llamar a una API. Las capas inferiores deciden; esta ejecutaAgrega una herramienta nueva solo cuando el sistema realmente la necesite.
El orden es de abajo hacia arriba
Construyes el sistema siguiendo el orden de las capas: primero la identidad (los datos), después reglas/hooks, después skills, y solo entonces agentes e herramientas según lo requiera el uso. Quien empieza por los agentes está construyendo el techo antes que los cimientos.
Agente vs. subagente
Las palabras agente e subagente se confunden porque parecen lo mismo. No lo son. La diferencia es simple: uno agente es el trabajador que recibe la misión; un subagente es un especialista que ese agente al que se le asigna una parte del trabajo — y que devuelve solo el resultado, sin volcar todo el borrador de vuelta.
Agente: el titular
Recibe la tarea, mantiene el hilo y decide el camino. Es quien conversa contigo y quien garantiza que el trabajo llegue a su fin. En el ejemplo de salud: el coach general que lee tus marcadores antes de cualquier respuesta.
- •Tiene el contexto de toda la misión
- •Decide cuándo llamar a un especialista
- •Une las piezas y entrega el resultado
Subagente: el especialista
El agente lo invoca para una parte específica, hace solo eso y devuelve una conclusión breve — no la cantidad de archivos que leyó. En el ejemplo: un especialista de metabolismo, otro de entrenamiento, otro de suplementación.
- •Mira solo la parte que te correspondió
- •Trabaja en una ventana de contexto propia
- •Devuelve la conclusión, no el borrador
🧠 Por qué separarlos funciona
La mayor ventaja de un subagente es proteger el contexto del titular. Cuando una tarea implicaría revisar decenas de archivos o registros, el agente delega: el subagente se sumerge en eso en la propia ventana y vuelve solo con la conclusión. El titular se queda con la respuesta, no con la basura de la búsqueda.
Es la misma lógica del mundo real: un director no lee cada hoja de cálculo; se lo pide a un analista y recibe el resumen. Cada subagente es un analista con un alcance y un entregable.
Regla práctica
Skill = una receta que se activa sola. Agente = un trabajador con un papel. Subagente = un ayudante al que el agente llama para una parte y que devuelve solo el resultado. La skill es qué; el agente es quién.
Cuándo «contratar» a un agente
Aquí está el error del que advierte el propio video de origen: "mucha gente se adelanta y crea agentes". La tentación es formar un ejército de agentes desde el comienzo, porque parece avanzado. Pero un agente solo se justifica cuando hay un rol con una línea clara que indique dónde empieza y dónde termina. Sin esta frontera, creaste complejidad, no capacidad.
📐 La prueba del "papel con principio y fin"
- ① ¿Se puede nombrar el rol en una frase? "El agente que hace X." Si necesitas un párrafo, el rol aún no está claro.
- ② ¿Dónde empieza? ¿Cuál es el disparador que activa a este agente y no a otro?
- ③ ¿Dónde termina? ¿Cuál es el entregable que indica que «terminó»? Sin una línea de llegada, el agente se vuelve un pozo sin fondo.
✓ Cuándo vale la pena crear un agente
- ✓El rol cabe en una frase, con un inicio y un final claros
- ✓La tarea es mutuamente excluyente: no se superpone con otra
- ✓Ya viste, en la práctica, cómo se repite este trabajo
- ✓Hay un entregable concreto que indica que está "listo"
✗ Cuándo es demasiado pronto (saltar el arma)
- ✗Creas el agente «porque parece avanzado»
- ✗Las reglas todavía se superponen: nada está delimitado
- ✗El rol solo describe en párrafos vagos dónde empieza y dónde termina
- ✗Una skill simple ya resolvería el mismo trabajo
La disciplina, expresada por el propio código fuente
"No tiene sentido agregar agentes al principio, porque todavía no he delimitado qué regla merece ser mutuamente excluyente frente a las reglas que se superponen." Espera a que el trabajo si se revelaCrea el agente cuando el límite de su función quede claro: no antes.
Paralelizar subagentes
Una vez que tienes subagentes, llega un superpoder: ejecutar varios al mismo tiempo. Cuando dos tareas no dependen una de otra, no hay motivo para hacerlas en fila. De hecho, este es un principio que los propios sistemas de vanguardia declaran: "las llamadas independientes, sin dependencias entre sí, van en el mismo bloque" — en paralelo.
⚡ La ventaja de ejecutarlos juntos
✓ Se puede paralelizar cuando…
- ✓Las tareas son independientes: ninguna usa el resultado de la otra
- ✓Cada subagente tiene su propio alcance y entregable
- ✓Quieres cubrir varios frentes de investigación a la vez
- ✓No hay un estado compartido que uno pueda pisar en el otro
✗ NO paralelices cuando…
- ✗El paso B necesita lo que descubrió el paso A (es una cadena)
- ✗Dos agentes escribirían en el mismo archivo al mismo tiempo
- ✗El orden importa para el resultado final
- ✗Es una tarea única y pequeña — paralelizarla solo agrega sobrecarga
La pregunta que lo desbloquea todo
Antes de despachar, pregúntate: "¿el siguiente paso necesita el resultado del anterior?" Si no, envíalo junto. Si sí, es una cadena: respeta el orden. El trabajo independiente va en paralelo; el trabajo dependiente, en secuencia.
Ejemplo real: una skill de INEMA
Basta de abstracciones: vamos a abrir una skill real de INEMA. A video-explicativo toma uno asunto y devuelve un video narrado, animado y renderizado. Es el caso perfecto de Contrato de herramienta (Técnica 8)cada etapa del pipeline tiene un disparador, un prerrequisito y un orden: eso es lo que distingue a un agente que ejecuta de uno que va a tientas.
DISPARA quando: "fazer um vídeo", "vídeo sobre X", "vídeo pra Shorts" ① roteiro → escreve SCRIPT.md (beats do assunto) ② narração → gera os WAVs (TTS local) · pré-req: roteiro pronto ③ composição → monta as cenas animadas · pré-req: durações medidas ④ validar → lint + inspect (0 erro) · antes de renderizar ⑤ render → HTML → MP4 (16:9 e 9:16) REGRA DE OURO: a CTA do INEMA.CLUB é sempre a última cena.
Cada etapa solo se ejecuta después que entregó la anterior — la narración necesita el guion y la composición necesita las duraciones. Este es el contrato: cuándo, en qué orden, con qué requisito previo. Sin él, la IA intentaría renderizar antes de que existiera el audio.
🧱 Dónde aparece cada capa aquí
Identidad: el estándar de INEMA — PT-BR, dark premium ámbar, voz local. Es el fundamento que la skill da por sentado.
Regla: "el CTA de INEMA.CLUB siempre es la última escena" — innegociable, siempre aplica.
Skill: la propia video-explicativo, que se activa con una descripción rica en desencadenantes.
Agente: en un paquete más grande (el «productor»), un agente orquesta el plan → la dirección → el render, y llama a skills como esta.
Herramientas/CLIs: el TTS local, HyperFrames (HTML→MP4), FFmpeg: las manos que realmente generan el archivo.
Dónde se puede paralelizar (y dónde no)
Los dos formatos — 16:9 e 9:16 — son independientes: se pueden renderizar en paralelo. En cambio, el pipeline en sí (guion → narración → composición) es una cadenacada etapa necesita la anterior, así que se ejecuta en secuencia. Incluso dentro de una skill, separas lo que es independiente de lo que es dependiente.
⚠️ El punto ciego: verificar de verdad
La etapa que casi todos los pipelines tratan mal es la verificación. No basta con que la skill diga «rendericé». El contrato debe cerrarse con una cláusula de verificación:
- 1.El archivo existe en el destino correcto? (no confíes en el código de salida)
- 2.El lint pasó ¿con cero errores antes del render?
- 3.Narra fielmente lo que pasó — en vez de decir «listo» sin haberlo revisado.
🛠️ Manos a la obra: tu entregable
Antes de seguir, haz un borrador de la tuya. En 15 minutos tendrás el esqueleto de una skill y la claridad para saber si necesita un agente o no.
- 1 Elige una tarea repetitiva tuya (generar una publicación, resumir un informe, armar una diapositiva). Escribe la description con 3 a 5 frases de activación — las palabras reales que usarías al pedirlo.
- 2 Enumera el pipeline en orden: cada etapa con su prerrequisito (qué debe estar listo antes). Es tu contrato de herramienta.
- 3 Aplica la prueba del tema 4: ¿esto es una skill (una receta que se activa) o pide un agente (¿un papel con principio y fin)? Ante la duda, quédate con la skill.
- 4 Marca qué etapas son independientes (podrían ejecutarse en paralelo) y termina con una línea de verificacióncómo compruebas que la salida realmente existe.
📝 Resumen del Módulo
- ✓Una Skill é a description que se activa + el cuerpo que ejecuta; la description es la parte más importante
- ✓Las 5 capas del Agentic OS: identidad → reglas/hooks → skills → agentes/subagentes → herramientas/MCPs/CLIs
- ✓Agente mantiene la misión; subagente procesa una parte en su propio contexto y devuelve solo la conclusión
- ✓Contrata a un agente solo cuando el papel tiene un principio y un final claros — no te adelantes
- ✓Paraleliza qué es independiente; deja en secuencia lo que forma una cadena
- ✓Una skill real es un pipeline con contrato (disparador, orden, requisito previo) que termina verificando el resultado
➡️ Siguiente Módulo
2.7 — ✅ Verificación e informe fiel. Creaste la skill y diseñaste el agente. Ahora la pieza que lo completa todo: cómo hacer que la IA comprobar de verdad que el trabajo salió bien, y narrar lo que pasó sin decir "listo" a ciegas.