Creando tu primera habilidad
Crear una Habilidad es más sencillo de lo que parece. Vamos a hacerlo desde cero: una habilidad personal para redactar descripciones de pull requests con un formato siempre igual.
🌐 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
Paso 1: Crea la carpeta
El nombre de la carpeta debe coincidir con el nombre de tu habilidad. Como esta va a ser personal, la creas dentro de tu carpeta personal de Claude: ~/.claude/skills/pr-description.
Paso 2: Crea el archivo SKILL.md
El archivo tiene dos partes separadas por unos guiones: arriba el encabezado (con el nombre y la descripción), y debajo las instrucciones que Claude seguirá al activar la habilidad. En el ejemplo, la descripción dice que sirve para "escribir descripciones de pull requests", y las instrucciones le piden ejecutar git diff main...HEAD y redactar con un formato fijo: Qué, Por qué y Cambios.
Lo más importante es la descripción: es el criterio que usa Claude para decidir si activa la habilidad. Hazla específica y di claramente cuándo usarla.
Paso 3: Prueba la habilidad
Claude Code carga las habilidades al arrancar, así que reinicia la sesión después de crear una. Para comprobar que está disponible, usa el comando /skills y verás la lista.
Para probarla, haz algún cambio en una rama y escribe algo como "escribe una descripción de PR para mis cambios". Claude indicará que está usando la habilidad, revisará las diferencias y redactará la descripción siguiendo tu plantilla.
Cómo encuentra Claude tu habilidad
Al iniciarse, Claude Code escanea cuatro ubicaciones en busca de habilidades, pero solo carga el nombre y la descripción — no el contenido completo (esto ahorra contexto). El proceso es:
- ›Envías una petición.
- ›Claude la compara con las descripciones de todas las habilidades usando coincidencia semántica — por significado, no por palabras exactas.
- ›Cuando encuentra una que encaja, te pide confirmación antes de cargarla entera.
- ›Tras tu confirmación, lee el SKILL.md completo y sigue sus instrucciones.
Jerarquía de prioridades
Si dos habilidades se llaman igual, ¿cuál prevalece? Este es el orden:
| Prioridad | Ubicación | Para quién |
|---|---|---|
| 1ª — Empresa | Configuración administrada | Toda la organización (máxima prioridad) |
| 2ª — Personal | ~/.claude/skills | Solo tú, en todos tus proyectos |
| 3ª — Proyecto | .claude/skills del repositorio | Todo el equipo que clone el repo |
| 4ª — Plugins | Complementos instalados | Mínima prioridad |
Para evitar conflictos, usa nombres descriptivos: en lugar de "revisión", usa "revisión-frontend" o "revisión-backend".
Actualizar y eliminar
- ›Para actualizar una habilidad: edita su SKILL.md.
- ›Para eliminarla: borra su carpeta completa.
- ›Después de cualquier cambio: reinicia Claude Code para que surta efecto.
En una frase: crea la carpeta, escribe el SKILL.md con una buena descripción, reinícialo y pruébalo. Si algo no se activa, casi siempre es la descripción.
¿No programas? Te lo explico fácil · sin tecnicismos
Crear una habilidad suena técnico, pero es como escribir una receta y meterla en el recetario:
La carpeta y el archivo
Creas una carpeta con el nombre de la habilidad y, dentro, un archivo (el SKILL.md). Ese archivo tiene dos partes: una etiqueta que dice "para qué sirve" y las instrucciones de cómo hacerlo.
Claude la coge solo
No la activas tú. Cuando pides algo, Claude mira las etiquetas de todas tus recetas y, si una encaja con lo que pides, te pregunta y la usa.
Ponle un buen nombre
Si tienes dos recetas que se llaman igual, hay un orden de prioridad (primero las de la empresa, luego las tuyas, luego las del proyecto…). Para no liarte, ponles nombres claros, como "revisión-backend" en vez de solo "revisión".
En una frase: escribe la receta una vez, con una etiqueta clara de cuándo usarla, y Claude la aplicará sola cuando haga falta.
Glosario
Directorio (carpeta)
Carpeta del sistema de archivos. Cada habilidad vive en su propia carpeta, cuyo nombre coincide con el de la habilidad.
Una carpeta donde guardas la habilidad; se llama igual que la habilidad.
/skills
Comando de Claude Code que lista las habilidades disponibles junto con su descripción.
Un atajo que escribes para ver qué habilidades tienes a mano.
Coincidencia semántica
Emparejar tu petición con la descripción de una habilidad por significado, no por palabras literales.
Claude entiende lo que quieres decir aunque no uses las palabras exactas.
git diff
Comando de Git que muestra las diferencias del código; aquí, los cambios de tu rama frente a la rama principal (main).
Una orden que enseña qué ha cambiado en el código respecto a la versión principal.
Jerarquía de prioridades
Orden que decide qué habilidad gana si varias comparten nombre: empresa, luego personal, luego proyecto, luego plugins.
Quién manda si dos habilidades se llaman igual: primero la empresa, luego tú, luego el proyecto y por último los plugins.
Fuentes oficiales de Anthropic