Cómo crear una Agent Skill paso a paso
De elegir la tarea que merece la pena a publicarla: el proceso completo para escribir una Agent Skill que se active cuando toca y devuelva siempre el mismo resultado.
1. Elige una tarea que se repita y que hagas bien
Las skills que valen algo no son trucos generales, son experiencia profesional empaquetada. Si la tarea la resuelve igual de bien un prompt improvisado, no necesitabas una skill. El filtro es doble: tiene que repetirse en el tiempo y tú tienes que hacerla mejor que la media.
Los mejores candidatos suelen ser procesos que ya tienes interiorizados y que nunca has escrito: la checklist con la que revisas un contrato, el orden en que montas un informe mensual, los cinco errores que buscas siempre en una nómina, la estructura con la que presupuestas una obra. Eso es conocimiento que el modelo no tiene y que no puede deducir.
Descarta lo que ya hace bien cualquier modelo sin ayuda: resumir, traducir, corregir ortografía, redactar un email genérico. Ahí no aportas nada y la skill solo añade ruido.
2. Escribe la description antes que nada
Parece el último detalle y es lo primero que deberías escribir, porque es lo que decide si la skill llega a usarse. El agente no lee el cuerpo de todas tus skills antes de responder: lee el nombre y la descripción, y con eso elige. Una skill excelente con una description mala no se activa nunca.
Escríbela pensando en el agente y no en el comprador. No describe lo buena que es la skill: describe cuándo hay que usarla, con las palabras exactas que aparecerían en la petición real. Si tu skill revisa contratos de alquiler, la description tiene que contener "contrato de alquiler", "cláusula", "revisar" y "abusiva".
Añade siempre el límite. Decir para qué no sirve —"no aplica a locales comerciales ni a traspasos"— evita activaciones equivocadas, que son peores que no activarse: el usuario recibe un análisis con la checklist errónea y no tiene forma de saberlo.
3. Estructura el cuerpo como un proceso
Las skills que funcionan tienen tres bloques: el proceso paso a paso, los criterios para decidir en los casos dudosos, y el formato exacto de la salida. Si falta el proceso, el resultado varía cada vez. Si faltan los criterios, el agente resuelve las dudas a su manera. Si falta el formato, cada respuesta llega con una forma distinta y no puedes automatizar nada encima.
Escribe en imperativo y dirigido al agente: "identifica las partes y la duración", no "esta skill identifica las partes". Y añade un bloque de qué preguntar cuando falten datos, con la instrucción de preguntar en vez de suponer — es lo que separa una skill fiable de una que rellena huecos con invenciones plausibles.
Quita todo lo genérico. "Sé profesional", "hazlo con rigor", "usa un tono adecuado": el modelo ya lo intenta, y cada línea sin criterio compite por su atención con las que sí lo tienen.
4. Pruébala como si no la hubieras escrito
Instálala y pide la tarea de tres formas distintas
Con tus palabras, no con el nombre de la skill. Si solo se activa cuando la nombras explícitamente, la description es demasiado estrecha: amplíala con las formulaciones que acabas de usar y que no reconoció.
Dale un caso incompleto a propósito
Quítale un dato necesario y mira qué hace. Si lo inventa en vez de preguntarlo, al cuerpo le falta el bloque de datos requeridos. Este es el fallo que más caro sale cuando la skill acaba en manos de un cliente.
Dale un caso que no le corresponde
Si tu skill es de alquiler de vivienda, pásale un contrato de local. Debería negarse o avisar de que no aplica. Si lo analiza igualmente con la checklist equivocada, falta el límite en la description.
Compara dos ejecuciones del mismo caso
Pídele lo mismo dos veces en conversaciones distintas. Si los resultados difieren en el fondo y no solo en la redacción, el proceso no está lo bastante determinado: falta concretar pasos o criterios.
5. Los errores que más se repiten
El primero, con diferencia, es la description escrita como texto de venta. Es el único error que hace que todo el trabajo restante sea inútil, porque la skill simplemente no se activa.
El segundo es confundir extensión con calidad. Una skill de una página con criterios concretos rinde más que cinco páginas de recomendaciones generales, y además se lee mejor en el contexto del agente.
El tercero es no fijar el formato de salida. Sin él, el resultado es correcto pero irregular, y lo que la gente compra en una skill es precisamente que salga siempre igual.
Y el cuarto, propio de quien viene de escribir prompts: escribirla para el lector en vez de para el agente. Un SKILL.md no es documentación, son instrucciones que alguien va a ejecutar.
6. Publicarla y ponerle precio
Publicar una skill en MundoPrompt funciona igual que publicar un prompt: creas tu cuenta, conectas Stripe, eliges "Agent Skill" en el formulario, pegas tu SKILL.md, añades las instrucciones de instalación y ejemplos reales de resultado, y le pones precio. Pasa por revisión manual antes de aparecer en el catálogo.
Los ejemplos de salida son lo que más convence antes de comprar: una skill es un archivo de texto que nadie puede ver hasta pagarlo, así que lo único que tiene el comprador para decidir es lo que tú le enseñes del resultado.
El español es la ventaja competitiva y conviene explotarla en la elección del tema. Los catálogos en inglés apenas tienen skills pensadas para trámites, normativa y formatos hispanohablantes. Una skill de modelo 130, de nóminas según convenio o de contratos de arrendamiento español no compite con nadie.
Preguntas frecuentes sobre crear skills
¿Necesito saber programar para crear una Agent Skill?
No. Un SKILL.md es un archivo de texto con instrucciones en lenguaje natural. Lo que necesitas es dominar la tarea y ser capaz de escribir el proceso con orden. De hecho las mejores skills suelen venir de perfiles profesionales —gestoría, derecho, RRHH, finanzas— y no de programadores.
¿Cuánto tiempo lleva crear una skill decente?
Escribir la primera versión es cuestión de una o dos horas si ya dominas el proceso. Lo que lleva tiempo es la prueba: instalarla, formularle la petición de varias maneras y corregir la description hasta que se active siempre que debe y nunca cuando no debe.
¿Puedo convertir un prompt que ya tengo en una skill?
Es un buen punto de partida, pero no basta con copiarlo. Un prompt asume que lo pegas tú en el momento adecuado; una skill tiene que decidir sola cuándo aplica. Tendrás que escribir la description desde cero y, casi siempre, ampliar el cuerpo con los criterios y el formato de salida que en el prompt dabas por supuestos.
¿Cómo sé si mi skill se está activando?
Pídele la tarea con tus palabras, sin nombrar la skill, y comprueba si el resultado sigue tu proceso y tu formato. Si la respuesta es genérica, no se activó. También puedes pedirle directamente al agente que te liste las skills disponibles para confirmar al menos que está cargada.