Si para una misma tarea tienes que explicarle a la IA cada vez los pasos, el formato y los detalles a tener en cuenta, ha llegado el momento de convertirla en un Skill. En esencia, un Skill es una carpeta: dentro hay un SKILL.md que explica «cuándo usarlo y cómo hacerlo», y según haga falta se añaden scripts, material de referencia y plantillas. Normalmente la IA solo ve el nombre y una frase de descripción de cada Skill, y lee el contenido completo únicamente cuando decide que le sirve; por eso puedes instalar decenas de Skills sin saturar el contexto.
SKILL.md tiene tres partes
La primera son los metadatos del encabezado; lo más importante es name y description. name es un identificador corto, y description explica en una o dos frases qué hace el Skill y en qué situaciones debe usarse. La segunda parte es el cuerpo, donde van los pasos concretos: qué hacer primero, qué después, en qué formato entregar el resultado y cómo actuar ante imprevistos. La tercera son los archivos adjuntos, guardados en la misma carpeta, como scripts para procesar datos, documentos de normas extensos o plantillas de salida; en el cuerpo se indica cuándo hay que leer cada archivo.
La description decide si se invoca o no
Muchos Skills están muy bien escritos y aun así nunca se usan, y la causa casi siempre está en la description. La IA se basa en la description para decidir si una petición necesita ese Skill, así que debe ser tan concreta como una palabra clave de búsqueda: escribe cómo lo pediría el usuario, qué tipo de archivos procesa y qué resultado produce. «Ayuda a procesar documentos» es demasiado vago; «Convierte la transcripción de una grabación de reunión en un acta con tareas pendientes; úsalo cuando el usuario mencione actas de reunión, organizar una grabación o un resumen después de la reunión» es mucho más claro.
En el cuerpo, pasos; no teoría
El cuerpo está pensado para que la IA lo ejecute, no es un manual para personas. Usa pasos numerados, con una acción por paso; deja claras las condiciones, por ejemplo «si el archivo tiene más de 100 líneas, divídelo primero»; un ejemplo completo de entrada y salida sirve más que tres párrafos de principios. Las partes que requieren precisión, como conversiones de formato o cálculos con datos, conviene escribirlas como scripts dentro de la carpeta, para que la IA llame al script en lugar de reescribirlo cada vez.
Los 5 errores más comunes al escribir un Skill
Uno: una description demasiado genérica, de modo que no se activa cuando debería y se activa cuando no toca. Dos: meterlo todo en SKILL.md; un cuerpo de miles de palabras hay que leerlo cada vez, es lento y facilita que se pase por alto lo importante; el material largo debe ir en archivos adjuntos. Tres: escribir solo principios sin dar ejemplos; lo que la IA entiende por «conciso y profesional» no es lo mismo que entiendes tú. Cuatro: no probarlo y publicarlo nada más terminarlo; prepara algunas peticiones reales y comprueba si se invoca correctamente y si el resultado es aceptable. Cinco: escribir claves o credenciales dentro del Skill; los Skills suelen compartirse y copiarse, así que la información sensible debe ir en variables de entorno.
Del Skill personal al paquete de Skills para empresas
Un Skill de uso personal basta con que funcione; para compartirlo en un equipo o en una empresa hay que pensar además en control de versiones, revisión de seguridad, evaluación de resultados y distribución unificada. Esa es la distancia entre «un Skill que funciona bien» y «un paquete de Skills empresarial».
El curso Skills ilustrados (con lecciones en chino) explica en 56 lecciones ilustradas desde los principios de los Skills, y te guía desde un boceto en papel, paso a paso, hasta crear un paquete de Skills probado, con revisión de seguridad y listo para publicarse en el SkillHub de una empresa. Las primeras 6 lecciones son gratis.