---
title: "skills.sh: instala skills en varios agentes de programación con IA"
seoTitle: "Guía de skills.sh: instalar skills en agentes de programación"
navTitle: "Guía de skills.sh"
description: "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."
slug: skills-sh-install-skills-ai-coding-agents
lang: es
date: 2026-08-05
updated: 2026-08-05
author: "Chatcode"
category: guide
faq:
  - q: "¿Puede skills.sh instalar una misma skill para Codex y Claude Code?"
    a: "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."
  - q: "¿Cómo instalo una skill para todos los agentes compatibles?"
    a: "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."
  - q: "¿Es seguro instalar skills de skills.sh?"
    a: "No por definición. skills.sh realiza auditorías de seguridad, pero deja claro que no garantiza la calidad ni la seguridad de todas las skills. Antes de instalar una, lee SKILL.md, los scripts, las referencias, las dependencias y los accesos que solicita."
---

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](https://skills.sh/) ofrece un directorio para descubrir skills de
agentes. Su [CLI `skills`](https://github.com/vercel-labs/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:

```bash
npx skills add vercel-labs/agent-skills --list
```

Después, instala una skill para los agentes que deban usarla:

```bash
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:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent '*'
```

También hay un comando mucho más amplio:

```bash
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](https://agentskills.io/specification).

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:

```bash
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:

1. Abre su repositorio de origen y lee `SKILL.md` completo.
2. Revisa los archivos a los que hace referencia y cada script que la skill
   pueda ejecutar.
3. Comprueba su licencia, si se mantiene activamente, sus dependencias, su
   acceso a la red y sus notas de compatibilidad.
4. Busca instrucciones que choquen con las versiones de tu proyecto o con las
   reglas de `AGENTS.md` que ya tengas.
5. 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](https://skills.sh/docs#how-are-you-securing-skills).
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:

```bash
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](https://arxiv.org/abs/2603.15401)
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](https://arxiv.org/abs/2602.12670), 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](/articles/agents-md-claude-md-best-practices)
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:

```bash
# 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.
