Generador de Skills de Claude
Describe en lenguaje natural una tarea que repites constantemente y obtén un SKILL.md completo listo para colocar directamente en Claude Code, con el nombre y la descripción verificados en vivo frente a las restricciones reales de Agent Skills mientras escribes. El generador redacta la descripción con la forma «qué hace y cuándo usarla», porque ese campo es lo único que Claude lee para decidir si tu skill aplica a una solicitud. También marca en vivo un borrador que parece cubrir más de una tarea sin relación, ya que una skill con un alcance acotado se activa de forma mucho más fiable que una demasiado amplia.
1. Describe la tarea que repites
El lenguaje sencillo está bien. Cuanto más específico sea el flujo de trabajo, más preciso será el skill generado.
O empieza con uno de estos
Tu SKILL.md aparecerá aquí, totalmente editable, con el nombre y la descripción verificados contra las restricciones reales de Anthropic mientras escribes.
Lo que realmente contiene un SKILL.md
Un skill es simplemente una carpeta con un SKILL.md dentro: frontmatter YAML arriba, instrucciones en markdown abajo. Solo dos campos del frontmatter son obligatorios, y ambos tienen reglas estrictas que esta herramienta hace cumplir mientras escribes. name tiene un máximo de 64 caracteres, solo permite letras minúsculas, números y guiones, y no puede contener las palabras reservadas «claude» ni «anthropic». description debe no estar vacío y tener menos de 1024 caracteres - y es el único campo que merece que te lo pienses bien, porque es el texto que Claude lee para decidir si tu skill es relevante para una solicitud.
Por eso toda buena descripción nombra dos cosas: qué hace el skill y cuándo debe activarse. «Revisa el diff de un pull request» por sí sola no le da a Claude nada con qué emparejar. «Revisa el diff de un pull request y señala cambios riesgosos. Usar cuando el usuario pida revisar un PR o comprobar un diff antes de fusionar» le indica exactamente qué solicitudes pertenecen a este skill. El generador escribe las descripciones con esa forma, y marca la tuya si falta la mitad del disparador.
Debajo del frontmatter es markdown normal - una breve descripción general, una lista de pasos bajo ## Instructions, y ejemplos donde se los merezcan. Los skills más grandes también pueden referenciar archivos adicionales junto a SKILL.md (un REFERENCE.md, una carpeta scripts/ que Claude ejecuta vía bash) para que el detalle pesado solo se cargue cuando realmente se necesite.
Preguntas frecuentes
¿Qué es exactamente una skill de Claude?
Una skill es conocimiento procedimental que le entregas a Claude una vez para reutilizarlo siempre: una carpeta que contiene un archivo SKILL.md, compuesto por un encabezado YAML (un nombre y una descripción) más un cuerpo de instrucciones en markdown. Cuando una solicitud coincide con la descripción, Claude carga esas instrucciones y las sigue. Es la diferencia entre volver a escribir el mismo prompt de tres párrafos cada semana y simplemente escribir un comando slash. Una skill también puede referenciar archivos adicionales junto a ella - un FORMS.md, un REFERENCE.md, o scripts dentro de una carpeta scripts/ que Claude ejecuta vía bash, donde solo la salida entra en la conversación, no el código del script.
¿Cómo escribo una descripción de skill de Claude que realmente se active?
Indica qué hace la skill y cuándo debe usarla Claude, en ese orden, en lenguaje sencillo en tercera persona. La descripción es lo único que Claude compara con la solicitud de un usuario para decidir si ejecuta tu skill, así que una descripción vaga significa que quedará sin usar. Nombra los disparadores concretos que esperas - «Usar cuando el usuario pida revisar un PR, comprobar un diff, o pregunte qué parece arriesgado en estos cambios» - y mantente bajo el límite de 1024 caracteres. Este generador de SKILL.md redacta la descripción con esa forma de qué-más-cuándo y te avisa en vivo si una edición elimina la mitad del disparador.
¿Una skill es lo mismo que un comando slash personalizado?
Se superponen. Claude Code ha unificado ambos: un archivo de comando y una skill ofrecen el mismo comportamiento /<nombre> y aceptan el mismo encabezado, y ambos admiten el sistema de marcadores $ARGUMENTS. La diferencia es estructural - una skill es una carpeta, por lo que puede llevar archivos de apoyo, scripts y referencias de divulgación progresiva, y tiene su propio campo name (un archivo de comando ignora name y paths, porque su nombre de archivo es el nombre del comando). Un comando es un único archivo markdown, más rápido de escribir cuando la tarea es una instrucción corta. Recurre a este generador de skills personalizadas de Claude Code cuando el flujo de trabajo tenga pasos reales, y al generador de comandos slash cuando no los tenga.
¿Realmente debería dividir una skill grande en varias más pequeñas?
En la mayoría de los casos, sí - es el error más común en la práctica con Agent Skills. Una skill que intenta cubrir varias responsabilidades sin relación (por ejemplo, manejar commits, escribir descripciones de PR y actualizar un changelog, todo en una) se activa de forma poco fiable, porque su descripción debe cubrir vagamente las tres tareas a la vez, y Claude no puede determinar qué parte aplica a una solicitud dada. Una conocida revisión de 47 skills populares de la comunidad encontró que cuarenta de ellas en realidad empeoraban el resultado de Claude respecto a no usar ninguna skill, en gran parte por esta razón. Este generador marca en vivo un borrador que parece cubrir más de una tarea y recomienda dividirlo.
¿Estás creando algo corto, de una sola línea? El AI Slash Command Generator escribe la versión de archivo único - el mismo /command, con menos andamiaje.