Skills. El alma de la IA.

Una skill es un archivo (normalmente llamado SKILL.md) que vive dentro del workspace y describe a un agente cómo realizar una tarea específica. Su contenido típico incluye: el objetivo de la tarea, los pasos en orden, los comandos exactos a ejecutar, las fuentes de verdad que debe consultar, los errores conocidos que suele cometer un modelo en ese dominio y las formas de detectarlos, y los formatos de salida esperados.

Cuando el agente entra al workspace y detecta una tarea cubierta por una skill activa, la lee antes de actuar y la aplica automáticamente. No es un prompt opcional: es parte del cerebro del agente mientras está dentro de ese proyecto.

Un prompt es la instrucción que tú escribes en una conversación concreta. Vive en ese turno y desaparece cuando se cierra el chat.

Una skill es un archivo persistente dentro del proyecto que el agente lee cada vez que entra. La diferencia operativa es brutal: el prompt depende de que tú lo recuerdes, lo escribas bien y lo repitas siempre igual. La skill no depende de ti. Está siempre ahí, siempre la misma, leída automáticamente.

Por eso "eres un experto en X" no es una skill: solo es decirle al modelo que es algo. Una skill le da la habilidad real con pasos, errores, comandos y formatos. Una afirma. La otra enseña.

El proceso para crear una skill útil tiene tres fases.

Primero: trabajas con el agente en una tarea concreta durante el tiempo que haga falta y vas anotando cada error que comete y cómo lo corregiste.

Segundo: cuando ya has resuelto la tarea bien al menos una vez, le pides al propio agente que destile ese trabajo en un archivo SKILL.md con los pasos, los errores típicos y la solución a cada uno.

Tercero: guardas ese archivo dentro de la carpeta del proyecto. La próxima vez que entres a trabajar en lo mismo, el agente lee la skill y ya no comete los errores que tú le ayudaste a resolver.

Una skill bien hecha es memoria operativa cristalizada.

Cualquier conjunto de instrucciones que hayas estructurado para que un agente repita un trabajo concreto con tu nivel de exigencia es una skill, aunque no esté formalmente nombrada como SKILL.md.

Si tienes documentos donde explicas a la IA cómo escribir tu copy, cómo formatear tus informes, cómo seguir tu metodología o cómo resolver un tipo concreto de problema, eso es habilidad cristalizada.

La diferencia entre tenerlo así y tenerlo como skill formal es que la skill formal vive dentro del proyecto, se lee automáticamente y no depende de que tú la pegues en cada conversación. Pero el conocimiento ya estaba. Solo le falta la carpeta y el nombre del archivo.

Cada skill se guarda dentro del workspace del proyecto al que aplica. La convención más extendida es una carpeta llamada skills/ en la raíz del proyecto, con archivos SKILL.md dentro, uno por habilidad.

Cuando el agente abre el workspace, recorre esa carpeta y carga las skills disponibles. Una skill puede aplicar a un proyecto concreto (skill de licitaciones dentro del proyecto de licitaciones) o a un dominio que reutilizas en varios proyectos (skill de diseño que copias en cada proyecto web).

Cuanto más cerca esté la skill del trabajo donde se usa, mejor. Una skill perdida en otra carpeta es una skill que no existe para el agente.