Skills que llaman a otras skills: el coordinador

Skills que llaman a otras skills: el coordinador

Algunas tareas de tu negocio no son un solo paso: tienen varias etapas distintas, cada una con su propia lógica. Si intentas meter todo eso en una sola skill gigante, terminas con el mismo problema que viste en la lección 3.4: cuando algo sale mal, no queda claro cuál de las cinco cosas que hace falló, y corregirla se vuelve un enredo. Esta lección te enseña la solución: una skill coordinadora que ordena el proceso, y varias skills pequeñas que hacen una cosa cada una.

Por qué dividir en vez de meter todo en una skill

Piensa en un proceso de tres pasos: investigar, escribir, revisar. Si escribes una sola skill que hace los tres pasos de corrido, cualquier ajuste que necesites (por ejemplo, mejorar solo la parte de revisión) te obliga a tocar el archivo completo, con el riesgo de romper algo que ya funcionaba bien en los otros dos pasos. Si en cambio divides el proceso en tres skills separadas más una coordinadora, cada pieza se corrige sola, sin tocar las demás. Esa es la ventaja central: se corrige una pieza sin romper las demás.

Hay una segunda ventaja, menos obvia pero igual de importante: cada skill pequeña es más fácil de probar. Es más simple verificar que "ficha-propiedad" ordena bien los datos, por separado, que intentar revisar un proceso completo de principio a fin cada vez que cambias algo.

Cómo se escribe una skill coordinadora

Una skill coordinadora no hace el trabajo de fondo: su trabajo es decidir el orden y decirle a Claude qué skill usar en cada paso. Sus instrucciones deben cubrir tres cosas:

• El orden de los pasos. Qué skill se ejecuta primero, cuál sigue, y cuál va al final.
• Qué pasa entre pasos. Qué información del resultado de un paso se pasa al siguiente, y en qué formato.
• Dónde se detiene para pedir aprobación. El punto exacto del proceso donde Claude para y espera que una persona revise antes de seguir, sobre todo si el último paso implica publicar, enviar o comprometer al negocio frente a un cliente.

Un límite importante para cuando empiezas: no encadenes más de cuatro pasos al principio. Un coordinador de dos o tres pasos es más fácil de probar y de corregir que uno de siete. Puedes crecer el proceso más adelante, cuando ya confíes en cómo se comporta cada pieza por separado.

El SKILL.md del coordinador, parte por parte

El coordinador de este ejemplo (llamado "anuncio-de-propiedad") ordena tres pasos: limpiar los datos de una propiedad, escribir el anuncio y revisar el lenguaje legal antes de publicar. Un SKILL.md de coordinador tiene estas partes:

• Encabezado entre guiones (name y description). El nombre corto del proceso y una frase de cuándo se usa.
• Orden de los pasos. Qué skill va primero, cuál sigue y cuál cierra el proceso.
• Qué pasa entre pasos. Qué información viaja de un paso al siguiente, y qué hacer si falta un dato.
• Dónde se detiene para pedir aprobación. El punto exacto donde el coordinador para y espera a una persona antes de publicar, enviar o cobrar.

Este es el esqueleto, con la misma estructura y los límites de seguridad ya escritos:

---
name: [nombre-corto-de-tu-proceso]
description: Coordina el proceso completo de [tu proceso]:
  [lista breve de las etapas]. Úsala cuando [cuándo se dispara
  este proceso en tu negocio].
---

# Coordinador: [nombre de tu proceso]

## Orden de los pasos
1. Usa la skill "[skill 1]" para [qué hace con los datos de
   entrada].
2. Pasa el resultado a la skill "[skill 2]" para [qué hace].
3. Pasa el resultado a la skill "[skill 3]" para [qué hace].

## Qué pasa entre pasos
- [Qué información pasa de un paso al siguiente, y en qué
  formato].
- Si a una skill le falta un dato del paso anterior, debe
  pedirlo, nunca inventarlo.

## Dónde se detiene para pedir aprobación
- Al terminar el último paso, el coordinador se detiene siempre.
  Muestra el resultado final y espera la aprobación de [quién
  aprueba] antes de [publicar, enviar o cobrar].
- Nunca completes esa acción sin esa aprobación explícita.

Pégale este esqueleto ya completado a Claude, junto con el siguiente prompt, para que te escriba el archivo completo:

Ayúdame a escribir el SKILL.md completo de un coordinador para
mi negocio, a partir de este esqueleto y estos datos.

Mi esqueleto completado:
[pegar aquí el esqueleto con tus pasos y tus datos]

Escribe el archivo completo en el mismo formato del esqueleto,
con encabezado, orden de los pasos, qué pasa entre pasos y dónde
se detiene a pedir aprobación.

Respeta los límites de seguridad que ya están en el esqueleto:
la aprobación humana antes de publicar, enviar o cobrar, y no
más de cuatro pasos encadenados.

Si te falta un dato de mi negocio para completar alguna parte,
pregúntame antes de escribirla. No inventes datos que yo no
te haya dado.

Con este coordinador, las tres skills pequeñas ("ficha-propiedad", "texto-anuncio", "revision-legal") viven por separado, cada una con su propio SKILL.md, su propia descripción y sus propios ejemplos, siguiendo exactamente el formato que viste en la lección 3.4.

Ejemplo

Una inmobiliaria en Santiago de los Caballeros repite el mismo proceso cada vez que sale una propiedad nueva a la venta: ordenar los datos que le manda el agente, escribir el anuncio y revisar que no diga nada que la empresa no pueda garantizar. Antes lo hacían con una sola persona revisando todo el texto a mano, un paso a la vez.

Arman el coordinador "anuncio-de-propiedad" con el archivo de arriba, más las tres skills pequeñas. Cuando el agente manda los datos crudos de una casa nueva ("3 cuartos, 2 baños, 180 metros, cocina remodelada, cerca de la escuela, precio [PRECIO]"), el coordinador activa primero "ficha-propiedad", que ordena esos datos en un formato limpio. Después pasa esa ficha a "texto-anuncio", que redacta el anuncio con el tono que ya tenían definido. Por último, "revision-legal" revisa el texto y marca una frase que el agente había escrito de más: "la propiedad se va a valorizar rápido en esta zona", una promesa que la inmobiliaria no puede garantizar.

El coordinador se detiene ahí, muestra el anuncio completo con esa frase señalada y el motivo de la marca, y espera a que el agente decida si la quita o la reescribe. Solo cuando el agente aprueba el texto final, alguien lo publica. Si más adelante quieren mejorar solo la parte de revisión legal (agregar otra frase prohibida a la lista, por ejemplo), editan únicamente la skill "revision-legal", sin tocar ni el coordinador ni las otras dos skills.

Errores comunes

• Encadenar demasiados pasos desde el principio. Empieza con dos o tres, no con siete: un proceso largo sin probar es difícil de depurar cuando algo sale mal.
• No definir claramente qué información pasa de un paso al siguiente. Si el formato de salida de un paso no coincide con lo que espera el siguiente, el proceso se rompe a la mitad.
• Olvidar el punto de aprobación en el proceso. Si el último paso del coordinador termina en algo que compromete al negocio (publicar, enviar, cobrar), el coordinador tiene que detenerse ahí siempre, sin excepción.
• Dejar que una skill pequeña invente datos que le faltan del paso anterior. Cada skill del proceso debe pedir lo que falta, nunca suponerlo.
• Construir el coordinador antes que las skills pequeñas. Es más fácil probar primero cada skill por separado y después armar el coordinador que las une, aunque también puedes escribir el coordinador primero como guía, como hiciste en tu tarea de esta lección.

Tu tarea

1. Dibuja tu proceso de tres pasos más repetido en tu negocio: el que hoy sigues siempre en el mismo orden.
2. Para cada paso, decide qué skill lo va a resolver, aunque esa skill todavía no exista.
3. Define qué información pasa de un paso al siguiente y en qué formato.
4. Marca con claridad en qué punto del proceso el coordinador se detiene a pedir tu aprobación.
5. Completa el esqueleto de esta lección con tus tres pasos y pégaselo a Claude junto con el prompt, para que te escriba el SKILL.md completo del coordinador, aunque todavía no hayas construido las skills pequeñas que menciona.

¿Quieres el equipo ya armado?

Todo lo de este curso es gratis y lo puedes armar tú, pieza por pieza, con el esqueleto y el prompt de cada lección. Si prefieres ahorrarte el armado, en Sinsajo Creators Pro está el curso Tu Equipo de IA: implementación, con el SKILL.md terminado de cada empleado, del coordinador, de la mesa de debate y de las misiones, listo para copiar e instalar. Además tienes los recursos nuevos que vamos creando y los en vivos semanales para revisar tu equipo.