Una skill es una carpeta con un SKILL.md dentro: una cabecera YAML breve y unas instrucciones en Markdown. Las instrucciones son la parte a la que se dedica el tiempo, y la descripción es la que decide si esas instrucciones llegan a leerse. Se compara con la tarea que hay entre manos, así que una que dice de qué trata la skill pero nunca cuándo recurrir a ella se quedará sin usar indefinidamente, y sin ningún error que explique por qué. Este creador escribe el archivo y revisa ese campo con especial atención: si nombra un disparador, si es lo bastante larga para que haya coincidencia y si desperdicia sus primeras palabras. El nombre se comprueba contra las reglas de nomenclatura de carpetas, y las instrucciones contra la longitud por debajo de la cual rara vez cambian nada.
Características
Nombre comprobado contra las reglas de carpetas, con una versión corregida propuesta
Descripción revisada en busca de una cláusula de disparo: lo que realmente provoca la coincidencia
Avisa cuando una descripción es demasiado corta para aportar señal
Lista opcional de herramientas permitidas, elegida en vez de escrita
Una puntuación que separa los errores bloqueantes de las sugerencias
La ruta exacta donde va el archivo
Frontmatter entrecomillado correctamente: dos puntos en la descripción no parten el valor
Se descarga como SKILL.md, listo para colocar
Cómo usar Constructor de skills
Nombra la skill en minúsculas y con guiones
Escribe una descripción que diga qué hace y cuándo usarla
Redacta las instrucciones en Markdown
Lee los hallazgos y descarga el SKILL.md
Ejemplo
Entrada
name: release-notes
Salida
description: Writes release notes from a range of git commits. Use when the user asks for a changelog.
La cláusula «Úsala cuando…» es lo que convierte un tema en un disparador.
Errores comunes y solución de problemas
La skill nunca parece usarse. — Casi siempre es la descripción. Tiene que decir cuándo aplica, con las palabras que alguien usaría de verdad: tipos de archivo, nombres de tarea, frases que escribiría.
El nombre se rechaza. — También es el nombre de la carpeta, así que debe llevar solo minúsculas, dígitos y guiones simples. Se propone una versión corregida cuando el tuyo no encaja.
Mi descripción lleva dos puntos y el archivo se rompe. — No debería: los valores se entrecomillan cuando hace falta. Si editas el archivo después a mano, entrecomilla todo lo que lleve dos puntos seguidos de espacio.
La skill carga pero no cambia nada. — Unas instrucciones muy breves rara vez modifican el comportamiento. Di qué producir, cómo trabajar y qué no hacer.
Preguntas frecuentes
¿Qué hace buena a la descripción de una skill?
Responde a dos preguntas en una o dos frases: qué hace la skill y cuándo debe usarse. La segunda mitad es la que se compara, así que nombra los tipos de archivo, la tarea y el modo en que la gente lo diría. «Ayuda con documentos» no coincide con nada en concreto.
¿Dónde va el archivo?
En una carpeta con el nombre de la skill, dentro de un directorio de skills. La ruta aparece bajo el editor y se actualiza mientras escribes el nombre. El nombre de la carpeta y el del campo deben coincidir.
¿Debo indicar una lista de herramientas permitidas?
Solo cuando la skill necesite menos herramientas de las que tiene la sesión. Dejarla vacía hace que herede lo disponible, que suele ser lo deseable; restringirla es una forma de mantener enfocada una skill enfocada.
¿Cuánto deben ocupar las instrucciones?
Lo suficiente para ser concretas y nada más. Unas pocas frases rara vez cambian el comportamiento; varias páginas acaban leyéndose por encima. Las secciones con encabezados envejecen mejor que un bloque largo.
¿Se valida el archivo en algún otro sitio?
El cargador acepta sin problema un archivo con una descripción floja, y ese es justamente el problema. Nada te avisa después de que la skill sea imposible de asociar, y por eso la comprobación toca hacerla antes de publicarla.
Herramientas relacionadas
Linter de skills — Pega un SKILL.md y descubre qué impide que se asocie a una tarea.
Constructor de subagentes — Crea el archivo de definición de un subagente con sus herramientas y modelo.
Constructor de comandos — Crea un comando propio, con argumentos y una lista de herramientas.