Skills: instalar capacidades específicas a tu agente de IA
Qué es una Skill, qué contiene un archivo SKILL.md y las tres formas de instalarlas en Claude Code, Cursor o Windsurf: desde skills.sh, desde archivo local o pidiéndoselo al propio agente.
Pablo Merino
Fullstack Developer • • 4 min de lectura
Contenidos
Los agentes de IA son potentes por defecto. Pero con Skills, les instalas capacidades específicas para las tareas concretas de tu proyecto. En este episodio te mostramos cómo funcionan y las tres formas de instalarlas.
¿Qué es una Skill?
Una Skill es un archivo Markdown con instrucciones estructuradas que le dicen al agente cómo hacer algo concreto: qué buenas prácticas seguir, qué patrones usar, qué errores evitar.
En vez de repetir esas instrucciones cada vez que arrancás una tarea, la Skill las encapsula y las vuelve reutilizables. Las podés usar en Claude Code, Cursor, Windsurf o Copilot, el concepto es el mismo en todos.
Sin Skill → repetís las mismas instrucciones cada vez
Con Skill → el conocimiento queda encapsulado y reutilizableQué hay adentro de una Skill
Una Skill bien escrita tiene una estructura clara y predecible. Cuatro secciones definen el archivo:
markdown
# Nombre y descripción
Qué hace esta Skill y cuándo el agente debería usarla.
# Instrucciones y reglas detalladas
El paso a paso de cómo abordar la tarea correctamente.
# Ejemplos y casos de uso
Situaciones concretas donde aplicar la Skill, con ejemplos reales.
# Reglas: qué evitar
Errores comunes o patrones que el agente no debe seguir.Cualquiera puede abrir el archivo y entender exactamente qué hace, sin necesidad de ejecutarlo. Es documentación y comportamiento al mismo tiempo.
Un detalle importante: las Skills no se cargan todas juntas
El agente detecta el contexto en el que estás trabajando y carga solo la Skill que necesita en ese momento. Si estás trabajando en frontend, carga la Skill de frontend. Si estás escribiendo tests, carga la de testing.
Esto evita saturar el contexto con instrucciones irrelevantes para la tarea actual, algo que, como vimos en el episodio sobre context window, tiene un costo real en la calidad de las respuestas.
Las tres formas de instalar una Skill
1. Desde un catálogo público: skills.sh
La forma más rápida cuando buscás una capacidad que ya existe. skills.sh funciona como un catálogo central de Skills, el equivalente al npm de los agentes.
El flujo es simple:
Buscás lo que necesitás en el catálogo.
Revisa el autor y el repositorio antes de instalar (igual que harías con cualquier paquete de npm).
Copia el comando
npxque te ofrece la página.Lo ejecutas en tu proyecto y seleccionas el agente con el que vas a usarla.
Ejemplo real: instalar find-skills, de vercel-labs.
bash
npx find-skills@latest install
# Seleccionás: Claude CodeUna vez ejecutado, la Skill queda disponible inmediatamente en tu proyecto.
2. Desde un archivo local
Si tenés una Skill que creaste vos mismo o que descargaste de un repositorio, la segunda forma es directa: copiarla en la carpeta correcta del proyecto.
.claude/skills/ → para Claude Code
.cursor/skills/ → para CursorEl agente la reconoce automáticamente la próxima vez que arranca, sin pasos adicionales.
Esta forma es especialmente útil para Skills propias del equipo que no están publicadas en ningún catálogo, conocimiento interno, convenciones específicas de un cliente, o flujos particulares de un proyecto.
3. Pidiéndole al agente que la instale
La tercera forma es la más directa de todas: pedírselo al propio agente.
Una vez que tenés find-skills instalado (de la primera forma), podés decirle directamente:
"Buscá una Skill para trabajar con Pull Requests"El agente busca opciones reales dentro del ecosistema, te muestra cuáles existen, y desde ahí podés pedirle que instale la que elegiste. Pasás de una necesidad concreta, "quiero trabajar mejor con PRs", a una Skill lista para usar, todo desde el mismo chat, sin salir a buscar manualmente.
Por qué esto importa más allá de la comodidad
Las Skills son la forma en que el conocimiento técnico se vuelve reutilizable. No queda atrapado en la cabeza de una sola persona del equipo, queda en el repositorio, versionado, documentado, y cualquier agente puede usarlo.
Es la diferencia entre depender de que alguien recuerde explicarle al agente "así es como hacemos los tests acá" cada vez, y tener esa instrucción ya encapsulada y lista para que cualquier desarrollador del equipo la aproveche.
El ecosistema crece todas las semanas: ya hay Skills para testing, migraciones, diseño, documentación y mucho más. Y, como vimos, también podés crear las propias para tu equipo o tu proyecto.
Lo que viene en el próximo episodio
Hasta ahora vimos cómo darle contexto persistente al agente (AGENTS.md) y cómo instalar capacidades específicas (Skills). El siguiente paso lógico es hacia afuera: cómo hacer que cualquier modelo entienda de forma eficiente el contenido de tu sitio web.
En el próximo video vemos llms.txt.
Etiquetas
Sobre el autor
Pablo Merino
Fullstack Developer


