¿Qué son las skills de Claude Code y por qué cambian tu forma de trabajar?

Si trabajas con Claude Code, seguro que te suena esta escena: cada vez que quieres que revise un pull request, le explicas de nuevo cómo quieres que estructure sus comentarios. Cada vez que escribes un commit, le recuerdas el formato que prefieres. Cada vez que le pides que documente algo, repites por enésima vez el estándar de tu equipo.

Esa repetición constante no solo es molesta: es tiempo perdido. Y ahí es donde entran en juego las skills.

Una skill es, en esencia, un archivo markdown que enseña a Claude cómo hacer algo una sola vez. A partir de entonces, Claude aplica ese conocimiento automáticamente siempre que sea relevante. Es como tener un manual de estilo interno que el modelo consulta por su cuenta, sin que tú tengas que recordárselo.

¿Qué son exactamente las skills?

Las skills son carpetas de instrucciones, scripts y recursos que Claude puede descubrir y utilizar para hacer las cosas con más precisión y eficiencia.

En el caso de Claude Code, el corazón de una skill es un archivo SKILL.md. Dentro de él, hay un elemento clave: la descripción. Esa descripción es lo que Claude usa para decidir si debe activar la skill o no.

El mecanismo es sencillo pero potente:

1. Tú haces una petición, por ejemplo: “Revisa este PR”.
2. Claude lee tu solicitud.
3. La compara con las descripciones de todas las skills disponibles.
4. Activa las que coinciden con lo que pides.

Así, si tienes una skill llamada “revisión de PR con nuestro estándar de equipo”, Claude la detectará y la aplicará automáticamente, sin que tengas que invocarla ni explicar nada.

¿Dónde se guardan las skills?

Las skills se pueden almacenar en distintos lugares según quién las necesite.

Skills personales

Van en el directorio personal (~/.claude/skills) y te siguen a través de todos tus proyectos. Aquí es donde pones tus preferencias: tu estilo de mensajes de commit, tu formato de documentación, cómo te gusta que te expliquen el código. Son tuyas, para tu forma de trabajar.

Skills de proyecto

Se guardan en .claude/skills dentro del directorio raíz de tu repositorio. Cualquiera que clone el repositorio obtiene estas skills automáticamente. Aquí es donde viven los estándares de equipo: las guías de marca de la empresa, las fuentes y colores preferidos para diseño web, las convenciones compartidas.

Esta distinción es importante porque resuelve un problema clásico: cómo hacer que todo un equipo trabaje con los mismos criterios sin tener que repetirlos a cada nueva incorporación o en cada conversación con la IA.

Skills frente a otras formas de personalización

Claude Code ofrece varias maneras de personalizar su comportamiento. Entender en qué se diferencian las skills de las demás es clave para sacarles partido.

Skills vs. CLAUDE.md

Los archivos CLAUDE.md se cargan en cada conversación. Si quieres que Claude use siempre TypeScript en modo estricto, eso va en tu CLAUDE.md. Se aplica de forma global, siempre presente.

Las skills, en cambio, se cargan bajo demanda, solo cuando coinciden con tu solicitud. Y hay un detalle técnico importante: solo se carga el nombre y la descripción de la skill, no su contenido completo, hasta que realmente se activa. Esto significa que no llena toda tu ventana de contexto con información que no necesitas en ese momento.

Piénsalo así: tu checklist de revisión de PR no necesita estar presente cuando estás depurando código. Solo se carga cuando pides una revisión.

Skills vs. comandos slash

Los comandos slash requieren que los escribas tú. Las skills, no. Claude las aplica cuando reconoce la situación. Es la diferencia entre tener que recordar un comando y que la herramienta se anticipe a lo que necesitas.

¿Para qué sirven mejor las skills?

Las skills brillan con conocimiento especializado que aplica a tareas concretas. Algunos ejemplos claros:

• Los estándares de revisión de código que sigue tu equipo.
• Los formatos de mensaje de commit que prefieres.
• Las guías de marca de tu organización.
• Cualquier convención interna que se repita una y otra vez.

La regla es simple: si te encuentras explicándole lo mismo a Claude una y otra vez, eso es una skill esperando a ser escrita.

¿Por qué esto es importante?

Las skills resuelven un problema real y cotidiano: la fricción de repetir instrucciones. Pero su impacto va más allá de ahorrar tiempo.

• Consistencia: todo el equipo trabaja con los mismos estándares, sin depender de que cada persona recuerde explicarlos.
• Eficiencia: el contexto no se llena con información irrelevante. Solo se carga lo que hace falta, cuando hace falta.
• Automatización real: no tienes que invocar nada. Claude reconoce la situación y actúa en consecuencia.
• Escalabilidad: cuando entra alguien nuevo al equipo, clona el repositorio y ya tiene todas las convenciones integradas.

Conclusión

Las skills representan un cambio de paradigma en la forma de trabajar con asistentes de IA. En lugar de tratar cada conversación como un borrón y cuenta nueva, permiten acumular conocimiento y aplicarlo automáticamente.

Ya sean tus preferencias personales o los estándares compartidos de tu equipo, las skills convierten la repetición en automatización. Y en un mundo donde la productividad depende cada vez más de saber delegar bien, esa capacidad marca la diferencia.

La próxima vez que te descubras explicándole lo mismo a Claude por tercera vez, pregúntate: ¿esto debería ser una skill? Muy probablemente, la respuesta sea sí.