¿Qué son las Habilidades?
Cada vez que le explicas a Claude los estándares de tu equipo, te repites. En cada revisión de una pull request vuelves a describir cómo quieres los comentarios; en cada commit le recuerdas tu formato. Las Habilidades solucionan justo eso.
🌐 Este vídeo es el original de Anthropic, en inglés. Para seguirlo en español, dale al play al audio 🎬 «Sigue el vídeo en español» de aquí abajo — es la traducción exacta de lo que se dice.
Sigue el vídeo en español
Escucha la lección
¿Qué es una Habilidad?
Una Habilidad es un archivo de texto que le enseña a Claude cómo hacer algo una sola vez. Después, Claude aplica ese conocimiento automáticamente siempre que lo necesita — sin que tengas que repetírtelo.
Son carpetas de instrucciones y recursos que Claude Code descubre y usa para hacer tareas con más precisión. Cada habilidad vive en un archivo SKILL.md con un nombre y una descripción en su encabezado.
La descripción es la clave: es el criterio que usa Claude para decidir si activa la habilidad. Cuando le pides que revise una PR, compara tu petición con todas las descripciones disponibles y carga las que coinciden. Tú no la activas — lo hace solo, en el momento justo.
¿Dónde viven las Habilidades?
Puedes guardarlas en dos sitios, según quién las necesite:
Habilidades personales
En tu carpeta personal (~/.claude/skills, o en Windows C:/Users/tu-usuario/.claude/skills). Te acompañan en todos tus proyectos: tu estilo de commits, tu formato de documentación, cómo prefieres que se explique el código.
Habilidades de proyecto
En .claude/skills, dentro del repositorio. Se comparten con todo el equipo al clonar el proyecto: estándares de código, directrices de marca, convenciones del equipo.
Habilidades, CLAUDE.md y comandos: ¿cuál es cuál?
| Herramienta | Cuándo se carga | Mejor para |
|---|---|---|
| CLAUDE.md | En cada conversación | Contexto siempre activo: stack, convenciones generales, comandos |
| Habilidades | Bajo demanda, cuando coinciden con lo que pides | Conocimiento especializado por tarea: revisión de PRs, commits, docs |
| Comandos /slash | Solo cuando los escribes tú | Acciones concretas que quieres lanzar tú mismo |
¿Cuándo crear una Habilidad?
Funcionan mejor para conocimiento especializado que se aplica a tareas concretas:
- ›Estándares de revisión de código de tu equipo
- ›Formato preferido de mensajes de commit
- ›Directrices de marca de tu organización
- ›Plantillas de documentación para tipos de archivo concretos
- ›Listas de verificación para depurar frameworks concretos
La regla de oro: si te encuentras explicándole lo mismo a Claude una y otra vez, eso es una habilidad que todavía no has escrito.
¿No programas? Te lo explico fácil · sin tecnicismos
¿No programas? Te lo cuento con una imagen sencilla.
Imagina que Claude es un ayudante nuevo en tu oficina. Cada día le tienes que recordar lo mismo: "los informes se hacen así", "los correos con este tono". Cansa, ¿verdad?
Una Habilidad es como dejarle una receta escrita una sola vez: "así reviso yo el trabajo", "así escribo yo los resúmenes". A partir de ahí, Claude la usa solo cuando hace falta, sin que se lo recuerdes.
Lo que de verdad importa
- ›No tienes que activarla: Claude la coge solo cuando tu petición encaja con ella.
- ›La puedes guardar para ti (te sigue en todo) o para tu equipo (la reciben todos).
- ›Y la regla más útil: si te oyes repitiendo lo mismo a Claude, eso es una receta que aún no has escrito.
Glosario
Habilidad (Skill)
Archivo SKILL.md con instrucciones que enseñan a Claude a hacer una tarea concreta; se carga sola cuando tu petición coincide con su descripción.
Una "receta" que le enseñas a Claude una vez y que aplica solo cuando hace falta.
SKILL.md
El archivo (en formato Markdown) que define una habilidad: un encabezado con nombre y descripción, y debajo las instrucciones.
El archivo donde se escribe la "receta" de una habilidad.
Encabezado (YAML)
La cabecera del SKILL.md, entre guiones, con el nombre y la descripción de la habilidad. La descripción decide cuándo se activa.
La ficha de arriba del archivo que dice cómo se llama la receta y para qué sirve.
CLAUDE.md
Archivo del proyecto que Claude lee en cada conversación; sirve para el contexto que siempre aplica.
La "ficha del proyecto" que Claude lee siempre, frente a la habilidad que solo se carga cuando encaja.
Repositorio
Carpeta del proyecto bajo control de versiones; las habilidades guardadas en .claude/skills se comparten con quien lo clone.
La carpeta del proyecto que comparte el equipo: lo que pones ahí lo reciben todos.
Pull request (PR)
Propuesta de cambios para revisar antes de fusionarla en la versión oficial del proyecto.
Una propuesta: "he hecho estos cambios, ¿los revisáis antes de meterlos?".
Fuentes oficiales de Anthropic