Una skill es una carpeta con un archivo SKILL.md: empieza con un frontmatter que incluye name y description, seguido de las instrucciones. Claude la carga cuando la descripción coincide con la tarea. Sirve para no tener que repetir las mismas reglas de estilo cada vez.
Estructura
.claude/skills/gta-asset/
SKILL.md
palette.md # colores y usos
checklist.md # comprobaciones finales
Ejemplo de SKILL.md
---
name: gta-asset
description: Crea animaciones originales con estética de GTA VI para el sitio de guías. Úsala cuando el usuario pida un fondo, una cortinilla, un HUD o una superposición animada.
---
# Reglas
- Un solo archivo HTML, sin dependencias externas.
- Paleta: consulta palette.md. Define los colores en variables CSS.
- Respeta prefers-reduced-motion y crea bucles continuos, sin saltos.
- Utiliza gráficos originales: nunca logotipos, personajes, tipografías ni audio de Rockstar.
# Procedimiento
1. Propón el concepto y la paleta en cinco líneas.
2. Crea el recurso.
3. Sigue checklist.md e indica qué has comprobado.
Por qué funciona
- Descripción precisa: especifica cuándo hay que usar la skill, no solo qué hace.
- Reglas verificables: «menos de 200 KB» se puede comprobar; «que quede bonito», no.
- Lista de control externa: mantén breve el archivo
SKILL.mdy guarda los detalles en archivos relacionados.
Combínala con Prompt Lab y el flujo de trabajo con agentes.
Preguntas frecuentes
¿Qué es una skill para Claude Code?
Es una carpeta que contiene un archivo SKILL.md con name, description e instrucciones. Claude la carga cuando su descripción coincide con la tarea.
¿Dónde se guarda una skill?
En .claude/skills/<nome>/SKILL.md.