Skills de Claude Code para programar: guía

Qué son las skills de Claude Code

Claude Code es un agente de código que trabaja desde la terminal dentro de tu proyecto: lee código, ejecuta comandos y edita archivos bajo tu dirección. Las skills son su memoria reutilizable para tareas repetidas. Una skill describe cuándo usarla, qué pasos seguir, qué restricciones respetar y qué formato debe tener la salida.

Una skill no es un plugin mágico ni un modelo distinto. Es texto: instrucciones escritas por ti o por otro desarrollador, que Claude Code lee cuando la invocas. Por eso una skill buena se nota en seguida: produce resultados más consistentes que improvisar el mismo flujo con un prompt largo cada vez.

Anatomía de una skill

Una skill típica es una carpeta con un archivo SKILL.md dentro. En ese archivo van, como mínimo, un nombre corto, una descripción de cuándo usarla y los pasos en orden. A eso se pueden añadir ejemplos, restricciones, como no modificar ciertos archivos sin avisar, y el formato esperado de la respuesta.

Ejemplo mínimo de SKILL.md para revisión de código:

# Revisión de código

Usa esta skill cuando te pidan revisar cambios.

Pasos:
1. Lee solo los archivos modificados.
2. Busca errores, casos borde y código sin pruebas.
3. Devuelve una lista corta, ordenada por gravedad.
4. No propongas cambios grandes sin explicar el motivo.

La regla de oro es la brevedad con precisión. Una skill de dos páginas que nadie lee entera ayuda menos que una de media página que se sigue siempre.

Cómo crear tu primera skill, paso a paso

Elige una tarea que repitas al menos una vez por semana, por ejemplo revisar un pull request o escribir pruebas para una función. Escribe la skill en un archivo SKILL.md, con nombre, descripción y pasos, y guárdala en la carpeta de skills de tu proyecto o en tu carpeta personal de skills, según la documentación actual de Claude Code.

Pruébala con una tarea real y corrige lo que falle: pasos que se saltan, instrucciones ambiguas o salidas demasiado largas. Repite ese ciclo dos o tres veces antes de crear una segunda skill. La mayoría de los problemas de las skills no son de Claude Code, son de instrucciones vagas.

Cómo instalar skills desde GitHub

Muchos desarrolladores publican colecciones de skills en GitHub. El flujo habitual es clonar o descargar el repositorio y copiar la carpeta de la skill que te interesa a tu carpeta de skills, o seguir las instrucciones de instalación del propio repositorio. Antes de instalar, lee el SKILL.md completo: si no entiendes qué hace, no lo instales.

Tres filtros antes de usar una skill ajena: primero, que su descripción coincida con tu tarea real; segundo, que sus pasos no pidan permisos ni acciones que no quieras, como borrar archivos o enviar datos fuera; tercero, que la pruebes en un proyecto de prueba antes de usarla en código importante. Las estrellas de un repositorio no garantizan calidad.

Biblioteca de skills: por dónde empezar

Empieza siempre por la documentación oficial de Claude Code, que es la referencia de cómo funcionan las skills y dónde se guardan en cada versión. Después, busca listas curadas en GitHub con términos como biblioteca de skills Claude, mejores skills para Claude Code o skills para programar, y compáralas: las que se repiten en varias listas suelen ser las más útiles.

Para programar, los tipos de skills que más se repiten son: revisión de código, escritura de pruebas, mensajes de commit, documentación y refactorización. No necesitas las cinco el primer día. Empieza por una, úsala una semana y solo entonces añade otra.

Errores comunes con las skills

El error más común es crear una skill demasiado larga o demasiado general, que intenta cubrirlo todo y no ayuda en nada concreto. El segundo es tener veinte skills y no recordar cuándo usar cada una: si tienes que buscar la skill más que usarla, tienes demasiadas. El tercero es copiar una skill ajena sin adaptarla a tu proyecto, con nombres de archivos y reglas que no aplican a tu caso.