Cómo escribir una skill reutilizable para un agente de IA

Repetir instrucciones detalladas todas las semanas es tedioso. Copiar un prompt largo en cada conversación también hace fácil olvidarse de alguna corrección. Una skill reutilizable le da al agente un lugar donde encontrar el procedimiento, pero igual necesita un disparador claro, límites seguros y una forma de comprobar el resultado.

Empezá por una tarea que realmente repetís

Supongamos que preparás un informe semanal de estado. Anotá los datos de entrada, el período, el formato y qué hacer si falta información. «Resumí las tareas cerradas de la semana por proyecto; identificá los bloqueos por separado» sirve más que «sé un gran gerente de proyectos». Probá con datos comunes de ejemplo antes de agregar información de clientes.

Hacé que la skill se pueda encontrar

Las skills de APX son carpetas que contienen un SKILL.md. Su descripción le indica al agente cuándo corresponde usarla; el cuerpo contiene pasos y ejemplos. En APX, las skills de proyecto están disponibles para los agentes de ese proyecto y las globales se heredan en los proyectos salvo que se desactiven. El agente todavía tiene que elegir y cargar la skill para una tarea: un archivo guardado, por sí solo, no demuestra que se haya usado.

Una lista breve puede cubrir:

Disparador: ¿cuándo corresponde aplicar el procedimiento y cuándo no?
Datos de entrada: ¿qué fuente y período hay que revisar?
Pasos: ¿qué tiene que hacer el agente y en qué orden?
Resultado: ¿qué secciones, enlaces o archivos debe producir?
Excepciones: ¿qué debe informar si una fuente no está disponible?
Verificación: ¿qué evidencia demostraría que el trabajo está completo?

Mantené separados los permisos

Una skill contiene instrucciones, no concede permisos. Revisá la configuración de autonomía y seguridad del agente antes de conectar servicios o enviar mensajes. No pongas contraseñas ni claves de API en la skill. Revisá las skills importadas y los archivos que traen antes de usarlas: que las instrucciones sean legibles no significa que sean correctas o seguras.

Mejorala con ejemplos reales

Ejecutá la misma tarea con la skill y revisá las fuentes y el resultado. Anotá qué hubo que corregir, actualizá el procedimiento y probá de nuevo con otro ejemplo. Una buena skill reduce explicaciones repetidas; no garantiza que el modelo siga todos los pasos ni que sus conclusiones sean correctas.