skills.sh: instala skills en varios agentes de programación con IA
Usa la CLI de skills.sh para instalar y mantener skills de agentes en Codex, Claude Code y otros agentes de programación sin duplicar instrucciones.
Si usas más de un agente de programación, copiar las mismas instrucciones en directorios separados de Claude Code, Codex, Cursor y OpenCode se vuelve un desorden enseguida. Cada copia puede ir divergiendo y cuesta saber qué versión está siguiendo cada agente.
skills.sh ofrece un directorio para descubrir skills de
agentes. Su CLI skills de código
abierto se encarga de la parte práctica: seleccionar skills de un repositorio,
instalarlas para uno o varios agentes y actualizarlas o eliminarlas más
adelante.
Respuesta rápida
Empieza por listar las skills de un repositorio sin instalar nada:
npx skills add vercel-labs/agent-skills --list
Después, instala una skill para los agentes que deban usarla:
npx skills add vercel-labs/agent-skills \
--skill web-design-guidelines \
--agent claude-code \
--agent codex
Para que esa skill concreta esté disponible en todos los agentes compatibles con la CLI, usa un comodín entre comillas para que la shell no lo expanda:
npx skills add vercel-labs/agent-skills \
--skill web-design-guidelines \
--agent '*'
También hay un comando mucho más amplio:
npx skills add vercel-labs/agent-skills --all
--all significa todas las skills encontradas y todos los agentes, sin pedir
confirmación. Es cómodo para un repositorio que es tuyo y que ya has revisado.
Para probar una colección pública que no conoces suele ser demasiado amplio.
Qué se instala
Una skill de agente es un directorio que contiene al menos un archivo
SKILL.md. Ese archivo tiene un nombre, una descripción que ayuda al agente a
decidir cuándo activarla y las instrucciones que debe seguir. Una skill también
puede incluir scripts ejecutables, material de referencia y recursos. La
estructura completa está documentada en la
especificación de Agent Skills.
La CLI skills conoce los directorios de proyecto y globales que usan decenas
de agentes de programación. Por ejemplo, apunta a .agents/skills/ para una
instalación de Codex a nivel de proyecto y a .claude/skills/ para Claude
Code. Puede crear enlaces simbólicos desde esos directorios de los agentes
hacia una única copia canónica de la skill. Así las instrucciones se mantienen
coherentes y una sola actualización sirve para varios agentes.
Usa --copy cuando los enlaces simbólicos no sean adecuados para el sistema de
archivos o el entorno de despliegue. Las copias son independientes, así que
mantener a todos los agentes en la misma versión pasa a ser responsabilidad
tuya.
Elige a conciencia entre ámbito de proyecto o global
La instalación por defecto es local al proyecto. Ejecuta el comando desde la raíz del proyecto cuando una skill recoja convenciones del repositorio, versiones de frameworks o un flujo de trabajo que el equipo deba poder revisar.
Añade --global (o -g) solo para un flujo de trabajo personal que deba
aplicarse en todos tus proyectos:
npx skills add vercel-labs/agent-skills \
--skill web-design-guidelines \
--agent codex \
--global
Las skills locales del proyecto son más fáciles de revisar junto al código al que afectan. Las globales reducen la repetición, pero también pueden hacer que dos desarrolladores obtengan un comportamiento distinto del agente con el mismo repositorio. Documenta cualquier skill global de la que dependa un flujo de trabajo compartido.
Usa el directorio para descubrir, no como prueba de calidad
La clasificación de skills.sh se basa en la telemetría anónima de instalaciones de la CLI. Un número de instalaciones puede indicar interés, pero no demuestra que una skill mejore los resultados de las tareas, esté al día o encaje con tu proyecto.
Antes de instalar una skill pública:
- Abre su repositorio de origen y lee
SKILL.mdcompleto. - Revisa los archivos a los que hace referencia y cada script que la skill pueda ejecutar.
- Comprueba su licencia, si se mantiene activamente, sus dependencias, su acceso a la red y sus notas de compatibilidad.
- Busca instrucciones que choquen con las versiones de tu proyecto o con las
reglas de
AGENTS.mdque ya tengas. - Pruébala en un proyecto y con una tarea repetible antes de hacerla global o instalarla para todos los agentes.
skills.sh dice que realiza auditorías de seguridad periódicas, pero también afirma que no puede garantizar todas las skills que lista. Ese es el límite que conviene asumir. Una skill son instrucciones, y a veces código, procedentes de otro repositorio; no es un sandbox ni una decisión de confianza.
La telemetría anónima de la CLI se puede desactivar para un comando con la variable de entorno documentada:
DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills --list
Más skills no hacen necesariamente mejor a un agente
Instalar una skill no aumenta la capacidad de fondo del modelo base. Le da al modelo instrucciones y recursos adicionales. Unas instrucciones útiles pueden hacer más fiable un flujo de trabajo especializado; las irrelevantes u obsoletas pueden consumir contexto, encorsetar un buen enfoque o entrar en conflicto con el repositorio.
Las primeras pruebas son dispares. Un benchmark reciente de skills de ingeniería de software informó de una mejora media de solo el 1,2 % en 49 skills públicas. Treinta y nueve no mostraron ninguna mejora en la tasa de éxito y tres la redujeron. Un estudio más amplio, SkillsBench, encontró una ganancia media considerable en varios dominios, pero también resultados negativos en algunas tareas y un mejor rendimiento de las skills específicas que de la documentación exhaustiva.
Ambos son preprints recientes, no un veredicto definitivo. Aun así, la lección práctica es útil: evalúa una skill con la misma tarea sin ella. Consérvala cuando el resultado sea más correcto, repetible o mantenible, no solo porque el agente haya dado una respuesta más larga.
Usa el mecanismo más pequeño que resuelva el problema
| Necesidad | Mejor punto de partida |
|---|---|
| Procedimiento repetible y propio de una herramienta, con archivos de apoyo | Una skill de proyecto específica |
| Flujo de trabajo personal que usas en muchos repositorios | Una skill global revisada |
| Reglas que todo colaborador y todo agente deben seguir siempre | Instrucciones de proyecto versionadas, como AGENTS.md |
| Una tarea inusual | Un prompt directo con el contexto necesario |
| Una política o comprobación determinista | Un script, un test, un formateador o una regla de CI |
| Indicaciones antiguas, genéricas o contradictorias | Ninguna skill hasta que se corrijan las indicaciones |
Esta distinción evita que una biblioteca de skills se convierta en un segundo sistema de configuración, menos visible. Las skills son más útiles para el conocimiento procedimental que un agente solo debe cargar cuando aparece una tarea que encaja. Los comandos y los límites duraderos que afectan a todo el repositorio deben ir en un archivo de instrucciones bien enfocado; consulta qué poner en AGENTS.md y CLAUDE.md para ver las pruebas y una plantilla compacta.
Mantén las skills instaladas bajo control
La CLI ofrece los comandos habituales del ciclo de vida:
# Show project and global skills
npx skills list
# Update one installed skill
npx skills update web-design-guidelines
# Remove it
npx skills remove web-design-guidelines
Revisa los cambios de origen antes de actualizar una skill que se use en producción o en todo un equipo. Si la reproducibilidad importa, anota en la documentación del proyecto el origen y la revisión que has comprobado, igual que harías con cualquier otra herramienta de desarrollo.
Lo sensato por defecto es ir con poco: instala una skill revisada en un
proyecto para los agentes que la necesiten. Amplía a --agent '*', al ámbito
global o a --all solo cuando el flujo de trabajo se haya ganado ese alcance.
Preguntas frecuentes
¿Puede skills.sh instalar una misma skill para Codex y Claude Code?
Sí. Pasa los nombres de ambos agentes a la CLI de skills, por ejemplo --agent codex --agent claude-code. La CLI instala una copia canónica y puede enlazarla en el directorio de skills que espera cada agente.
¿Cómo instalo una skill para todos los agentes compatibles?
Usa --agent '*' con un --skill concreto. La opción --all, más amplia, instala todas las skills encontradas para todos los agentes sin preguntar, así que revisa el origen antes de usarla.