Cómo convertir el trabajo de un empleado en una Skill para agentes de IA

Cuando una persona ejecuta una tarea crítica todos los días, acumula decisiones, criterios y pequeñas comprobaciones que rara vez aparecen en un manual. Ese conocimiento puede convertirse en una capacidad operativa para un agente de IA si se documenta con suficiente precisión.

Una Skill es un paquete versionable de instrucciones y recursos que un agente carga cuando la tarea lo requiere. No reemplaza el sistema de instrucciones principal ni depende de entrenar de nuevo el modelo: define una capacidad concreta, sus condiciones de uso, su procedimiento y la forma de comprobar el resultado.

1. Empieza por el momento de activación

La descripción de una Skill debe ayudar al agente a decidir cuándo usarla. Especifica la acción que resuelve, las frases que probablemente escribirá un usuario y los límites que la diferencian de otras capacidades.

Una descripción como “ayuda con ventas” es demasiado amplia. Una descripción útil indica el tipo de entrada, el resultado esperado y la situación concreta en la que debe activarse. Así se reducen activaciones omitidas y usos fuera de contexto.

2. Extrae el flujo real del empleado

Entrevista a la persona que realiza el trabajo y observa un caso completo. Registra qué recibe, qué revisa primero, qué preguntas hace, qué decisiones toma, qué excepciones encuentra y qué entrega al final.

1. Entrada: documentos, mensajes, datos, solicitudes o sistemas que consulta.
2. Secuencia: pasos en el orden en que realmente se ejecutan.
3. Decisiones: condiciones que cambian el camino del proceso.
4. Salida: archivo, registro, respuesta, aprobación o siguiente acción.
5. Control: comprobaciones que indican si el trabajo quedó bien hecho.

3. Diseña la Skill con divulgación progresiva

El agente no necesita cargar todas las instrucciones de todas sus capacidades en cada conversación. Mantén en el archivo principal lo indispensable para activar y ejecutar la tarea, y lleva plantillas, políticas, esquemas o scripts a recursos separados cuando crezcan.

Esta estructura reduce ruido, facilita el mantenimiento y permite que varias Skills compartan una fuente de verdad. El archivo principal debe decir qué hacer; los recursos pueden contener el detalle que solo se necesita en determinados casos.

4. Convierte el criterio humano en reglas revisables

Las frases “usa tu criterio” o “hazlo bien” no son suficientes para un agente. Reemplázalas con reglas observables, límites y ejemplos. Si un cálculo o una validación es determinista, conviene delegarlo a un script o herramienta y dejar explícito cómo debe ejecutarse.

• Define qué datos son obligatorios antes de continuar.
• Indica qué hacer cuando falta información o hay datos contradictorios.
• Separa las decisiones automáticas de las que requieren aprobación humana.
• Describe el formato exacto de la salida y los criterios de calidad.

5. Prueba, protege y versiona

Una Skill se debe probar con solicitudes reales y con casos parecidos que no deberían activarla. Conserva ejemplos positivos y negativos, revisa los resultados y ajusta la descripción cuando el agente elija la capacidad equivocada.

También debe declarar sus permisos y tratar archivos, páginas web, correos y mensajes externos como datos. No incluyas secretos en el archivo ni permitas que una instrucción encontrada dentro de una entrada externa cambie las reglas de la Skill.

Asigna un responsable, una versión y una fecha de revisión. Una Skill es un activo operativo: debe poder auditarse, actualizarse y retirarse cuando el proceso cambie.

Mapa rápido para documentar un proceso

Completa los campos y selecciona “Generar y descargar .skill”.