Añade capacidades reutilizables a los agentes de IA con skills.sh
Cada vez que inicias un nuevo chat con un agente de codificación de IA, empiezas desde cero. El agente no conoce la estructura de tus carpetas, tus convenciones para nombrar componentes ni las reglas de despliegue de tu equipo. Pegas el mismo bloque de contexto otra vez. Vuelves a explicar las mismas restricciones. Es tedioso y no escala.
skills.sh ofrece una solución práctica: un ecosistema en crecimiento de capacidades reutilizables para agentes que puedes instalar una vez y usar en todos los agentes y proyectos compatibles.
Puntos clave
- Las skills de los agentes son paquetes de instrucciones reutilizables y bajo demanda, definidos por un archivo
SKILL.mdcon frontmatter en YAML y un cuerpo en Markdown. - La divulgación progresiva mantiene las ventanas de contexto ligeras al cargar inicialmente solo los nombres y las descripciones de las skills, recuperando las instrucciones completas únicamente cuando son relevantes.
- La CLI de
skillste permite instalar, definir el ámbito y buscar skills entre proyectos sin escribir código de integración personalizado. - Las skills se diferencian de los servidores MCP: usa skills para flujos de trabajo repetibles basados en prompts, y MCP para interacciones tipadas, al estilo API, con sistemas externos.
- Inspecciona siempre las skills de terceros —especialmente las que contienen scripts— antes de instalarlas, ya que pueden ejecutarse en tu entorno local dependiendo de la configuración de tu agente.
¿Qué son las skills de los agentes de IA?
Una skill de agente es un paquete estructurado de instrucciones que un agente de IA puede cargar bajo demanda. En esencia, cada skill es un directorio que contiene un archivo SKILL.md con frontmatter en YAML y un cuerpo en Markdown:
my-skill/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable helpers
├── references/ # Optional: supplementary docs
└── assets/ # Optional: templates, configsEl frontmatter requiere como mínimo dos campos:
---
name: react-component-review
description: Reviews React components for performance issues, accessibility, and team conventions. Use when the user asks to review, audit, or check a component.
---El name debe coincidir con el nombre del directorio (en minúsculas, solo guiones). La description es lo que el agente usa para decidir si activa la skill: trátala como una regla de enrutamiento, no como un título.
Cómo la divulgación progresiva mantiene el contexto ligero
Este es el mecanismo que hace que las skills sean prácticas a escala. Los agentes no cargan todo el contenido de las skills de antemano. En su lugar, siguen tres pasos:
- Descubrimiento — Al inicio, solo se cargan
nameydescriptionen el conocimiento del agente. - Activación — Cuando una solicitud del usuario coincide semánticamente con la descripción de una skill, el agente lee el cuerpo completo del
SKILL.md. - Ejecución — Los scripts o archivos de referencia dentro de la skill solo se obtienen si las instrucciones lo requieren.
Esto significa que puedes registrar decenas de skills sin sobrecargar la ventana de contexto en cada solicitud.
Instalación de skills con la CLI de Skills
La CLI de skills es la interfaz principal para gestionar las skills de los agentes. No necesitas construir ninguna integración; basta con ejecutar:
npx skills add vercel-labs/agent-skillsOpciones comunes que realmente usarás:
# Install globally across all projects
npx skills add -g vercel-labs/agent-skills
# Install only specific skills from a repo
npx skills add vercel-labs/agent-skills --skill frontend-design
# List what's available before installing
npx skills add vercel-labs/agent-skills --list
# Search the ecosystem
npx skills find typescriptLas skills pueden instalarse con ámbito de proyecto (versionadas junto con tu repositorio y compartidas con tu equipo) o globalmente para tu uso personal. La CLI también admite rutas locales y URLs completas de Git.
Discover how at OpenReplay.com.
Skills frente a servidores MCP y plugins
Las skills no son lo mismo que los servidores MCP o los plugins de agentes. Los servidores MCP exponen herramientas tipadas que los agentes invocan con entradas y salidas estructuradas: son apropiados cuando necesitas un control estricto al estilo API sobre sistemas externos. Las skills son más simples: son simples instrucciones en Markdown que guían el comportamiento del agente sin requerir infraestructura de servidor.
Usa una skill cuando tengas un flujo de trabajo repetible que actualmente vive en un prompt que copias y pegas. Usa MCP cuando necesites que el agente interactúe con una API externa de forma controlada y tipada.
⚠️ Una nota sobre seguridad
Las skills no están verificadas por defecto. La plataforma skills.sh realiza auditorías periódicas, pero no puede garantizar la seguridad de cada skill publicada. Antes de instalar cualquier skill de terceros —especialmente las que incluyen un directorio scripts/— léela. Dependiendo de tu agente o entorno de ejecución, los scripts pueden ejecutarse en tu entorno local sin sandboxing.
El estándar emergente de Agent Skills
El formato Agent Skills se originó con Claude, pero ahora está documentado de forma independiente en agentskills.io y es compatible con múltiples plataformas, incluyendo OpenAI Codex, Spring AI y la cadena de herramientas de Vercel. Es una convención que está convergiendo, aún no un estándar finalizado, pero la estructura central (SKILL.md, frontmatter en YAML, directorios de soporte opcionales) es lo suficientemente estable como para construir sobre ella.
Conclusión
Si pasas tiempo reexplicando el mismo contexto del proyecto a tu agente de codificación, las skills son la herramienta adecuada. Convierten los prompts copiados y pegados en activos versionados y compartibles que se cargan solo cuando son necesarios, manteniendo el contexto de tu agente ligero y tu flujo de trabajo consistente. Empieza con npx skills init para crear el esqueleto de tu primera skill, o explora skills.sh para encontrar una que ya cubra tu flujo de trabajo.
Preguntas frecuentes
Necesitas un agente o cliente que admita la convención Agent Skills. El formato en sí es Markdown plano con frontmatter en YAML, pero solo funciona cuando tus herramientas implementan el patrón de descubrimiento y activación. Claude introdujo el concepto, y herramientas como la cadena de herramientas de Vercel, Spring AI y OpenAI Codex ahora lo admiten.
Un prompt de sistema siempre está cargado y se aplica a cada solicitud, lo que consume contexto en cada turno. Una skill se carga solo cuando su descripción coincide con la intención del usuario. Esta activación selectiva te permite mantener decenas de comportamientos especializados sin pagar el coste de tokens por adelantado, lo que hace que las skills sean más escalables que los prompts monolíticos.
Sí. La CLI de skills acepta rutas locales y URLs completas de Git, por lo que puedes alojar skills en un repositorio privado e instalarlas de la misma forma que harías con uno público. Las skills con ámbito de proyecto también pueden incluirse directamente en tu base de código, lo que las mantiene versionadas junto al proyecto al que dan soporte.
El agente decide qué skill activar basándose en la similitud semántica con la solicitud del usuario, por lo que las descripciones que se solapan pueden provocar enrutamientos impredecibles. Escribe las descripciones como reglas de enrutamiento precisas: menciona disparadores exactos, tipos de archivo o frases del usuario. Si dos skills realmente se solapan, considera fusionarlas o acotar una de forma más restrictiva para evitar conflictos.
Understand every bug
Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.
