Cómo crear una Skill de Claude: estructura, instalación y prueba del disparador
El formato ya está lo bastante definido como para montar una skill desde cero: un SKILL.md con frontmatter YAML, scripts opcionales y dos rutas de instalación distintas según se use Claude.ai o Claude Code.
Claude lee la descripción de una skill para decidir cuándo cargarla, así que lo que se escribe ahí no es marketing: es el disparador. Esa es la idea que sostiene todo el formato, y la razón de que una skill mal descrita no funcione aunque sus instrucciones sean impecables. El repositorio de Skills de Anthropic tiene los ejemplos, pero el armazón se monta en diez minutos.
El fichero que lo sostiene
Una skill es una carpeta con un único fichero obligatorio, SKILL.md. Dentro, frontmatter YAML con dos campos: name, con un tope de 64 caracteres, y description, con un tope de 200. El nombre de la carpeta hace de nombre del comando en Claude Code, y conviene que coincida con el campo name. Debajo va el cuerpo en Markdown: cuándo debe activarse la skill, qué estándares aplicar y en qué formato devolver el resultado.
El ejemplo que se usa en la guía es una skill de revisión de código que fija reglas concretas: tipos de retorno explícitos, prohibición de var, máximo de 50 líneas por función, 300 por fichero y complejidad de McCabe por debajo de 10. Son cifras de ejemplo, no valores que imponga el formato.
Ahí está la parte interesante del diseño. El cuerpo de SKILL.md se carga cada vez que la skill se activa, de modo que el material largo —listas de referencia, convenciones extensas— va en ficheros aparte dentro de la misma carpeta y se enlaza desde el documento principal. Claude solo los abre si los necesita. Es el mecanismo de divulgación progresiva que describe la primera parte de la serie.
Si un paso tiene que dar un resultado determinista, la recomendación es no pedírselo al modelo: se deja un script en scripts/ y se llama desde la skill. Un chequeo de complejidad, por ejemplo.
Instalarla y comprobar que dispara
La instalación cambia según dónde se use. En Claude.ai y en la aplicación de escritorio se comprime la carpeta en un zip —la carpeta de la skill tiene que quedar en la raíz del archivo, no anidada—, se sube y se habilita en Customize, luego Skills. En Claude Code no hay subida: la carpeta se guarda en .claude/skills/code-review/ dentro del repositorio si la skill es del proyecto, o en ~/.claude/skills/code-review/ si se quiere personal y disponible en todos los proyectos. La referencia de Skills en Claude Code detalla las rutas.
Para probarla hay dos vías. La primera: pedir algo que encaje con la descripción y comprobar que Claude avisa de que ha cargado la skill. La segunda, en Claude Code, invocarla directamente con /code-review. Después conviene repetir la misma petición en una sesión limpia con la skill desactivada y comparar las dos salidas. Si no hay diferencia apreciable, el problema está en las instrucciones, no en la instalación.
El material publicado cubre la creación, la instalación y la prueba; los patrones avanzados y el plan de adopción semanal quedan para entregas posteriores, y el texto se corta antes de desarrollarlos. Lo que sí queda claro es dónde está el trabajo real: en escribir una descripción que dispare en el momento correcto y en mantener el cuerpo corto. El resto lo resuelve la carpeta.
