Skills: el conocimiento que tu agente puede cargar

¿Qué es un skill?

Un skill es una carpeta que contiene un archivo llamado SKILL.md. Ahí dentro hay instrucciones. Cuando una tarea encaja con el skill, Claude carga las instrucciones por su cuenta. También puedes invocar un skill directamente, con /nombre-del-skill.

La estructura de SKILL.md

Cada SKILL.md empieza con una cabecera YAML entre dos líneas ---. Ahí van campos como name y description. Después viene el texto propiamente dicho: las instrucciones que recibe Claude. Un skill puede incluir otros archivos en la misma carpeta, por ejemplo un reference.md o un script. Claude solo carga esos archivos adicionales cuando realmente los necesita.

¿Skill o comando slash?

Los comandos slash al principio solo existían como archivos markdown simples en .claude/commands/. Esos archivos siguen funcionando. Pero los custom commands se fusionaron con los skills. Un archivo en .claude/commands/deploy.md y un skill en .claude/skills/deploy/SKILL.md generan el mismo comando /deploy. Un skill además puede traer consigo toda una carpeta de archivos. Y Claude puede cargarlo automáticamente en cuanto encaja con la tarea.

¿Cuándo merece la pena un skill?

¿Escribes una y otra vez las mismas instrucciones en el chat? ¿Una sección de tu CLAUDE.md ha crecido hasta convertirse en todo un procedimiento? Ese es un buen momento para convertirlo en un skill. Un skill solo carga su texto cuando hace falta. Eso ahorra contexto, comparado con un CLAUDE.md largo que siempre se carga entero.

Dónde viven los skills

• Personal: ~/.claude/skills/<nombre>/SKILL.md – para todos tus proyectos
• Proyecto: .claude/skills/<nombre>/SKILL.md – solo para este proyecto
• Plugin: <plugin>/skills/<nombre>/SKILL.md – donde sea que el plugin esté activo