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

📺 Ver el video en Instagram

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 reutilizable

Qué 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:

  1. Buscás lo que necesitás en el catálogo.

  2. Revisa el autor y el repositorio antes de instalar (igual que harías con cualquier paquete de npm).

  3. Copia el comando npx que te ofrece la página.

  4. 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 Code

Una 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 Cursor

El 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.

Autor

Sobre el autor

Pablo Merino

Fullstack Developer

Lecturas recomendadas

Profundiza en otros temas de ingeniería y tecnología.

Ver todo el blog

¿Estás pensando en tu próximo proyecto tecnológico?

En Devlights ayudamos a diseñar, construir y escalar soluciones digitales con criterio técnico, arquitectura sólida y foco en negocio.