Una skill es una receta reutilizable que le enseña a un agente de IA cómo hacer una tarea concreta: instrucciones empaquetadas y, a veces, archivos o scripts de apoyo. El agente no la lee siempre: ve su nombre y su descripción, y la carga cuando la tarea encaja. Tenerla instalada no significa que la use.
📝Tu tarea→🔎¿Encaja la descripción?→📖Carga la skill→📋Busca la evidencia
Ponlo a prueba
Una pregunta de la app. Elige una respuesta.
¿Cómo sabes si el agente usó la skill?
Estar instalada solo dice que estaba disponible. No prueba que la haya abierto.
Muchas herramientas muestran cuándo cargan una skill. Y el trabajo debería seguir sus pasos.
Sonar seguro no prueba nada. La prueba está en lo que hizo.
Las instrucciones viven en un archivo SKILL.md, con un nombre y una descripción. Algunas skills suman archivos de apoyo, como una plantilla o un ejemplo, y scripts para lo que tiene que salir exacto siempre igual. Dónde se instalan y cómo se activan cambia según la herramienta.
Una skill no es lo mismo que MCP. MCP conecta al agente con herramientas y datos de afuera; una skill le enseña cómo hacer algo. Tampoco es el archivo de reglas de tu proyecto: esas reglas orientan todo el trabajo, y la skill sirve para una tarea puntual.
Cómo decide usarla: la descripción
Cargar todas las recetas en cada tarea sería mucho texto y ocuparía ventana de contexto sin necesidad. Por eso el agente primero ve un resumen, el nombre y la descripción, y sólo carga el SKILL.md cuando cree que la tarea lo pide. Los archivos de apoyo los consulta cuando hacen falta.
Un ejemplo: armas una skill para revisar textos en español neutro, con «tú» y sin voseo, para una tienda que vende en México, Colombia y Argentina. Si la descripción dice sólo «ayuda con textos», el agente puede pasarla de largo. Si dice «revisa textos de clientes en español neutro: úsala antes de publicar una ficha de producto», es más probable que la elija justo ahí. Si es demasiado amplia, puede meterse donde no toca.
Instalada no es usada
Que una skill esté instalada sólo dice que está disponible. Si pides «arregla este bug» y tienes una skill para escribir tests, el agente puede no abrirla. Si quieres que la use sí o sí, pídela por su nombre en tu prompt.
Y después, revisa. Muchas herramientas muestran cuándo cargan una skill, y el trabajo debería seguir sus pasos. Que la respuesta suene segura no prueba nada: la prueba está en lo que hizo el agente.
Errores comunes
«Si la instalé, la va a usar.» No siempre: depende de la tarea y de la descripción. «Con una buena descripción, la usa seguro.» Ayuda, no garantiza. «Una skill conecta al agente con mis datos.» Eso se parece más a MCP: la skill es la receta, no la conexión.