--- title: "npx skills: instala y comparte skills para tu agente de IA" excerpt: "npx skills es un gestor de skills para agentes de IA hecho por Vercel Labs: instala las skills de cualquier repo de GitHub en Claude Code o Cursor con un comando. Ejemplo real con abr4xas/skills." date: "2026-07-03T18:30:00.000Z" lastModified: "2026-10-10T18:00:00.000Z" category: "Claude Code" tech_article: true author: name: "angel cruz" picture: "/images/me/angel-cruz.png" ogImage: url: "/images/open-graph/og-image.png" seo_title: "npx skills: instala skills para Claude Code y Cursor (2026)" seo_description: "Qué es npx skills (Vercel Labs) y cómo instalar skills de cualquier repo de GitHub en Claude Code o Cursor con un comando. Ejemplo con abr4xas/skills." --- **`npx skills` es un gestor de skills para agentes de IA, hecho por Vercel Labs.** Instala las skills de cualquier repositorio público de GitHub en tu agente (Claude Code, Cursor y otros) con un solo comando, sin copiar archivos a mano. Funciona como un gestor de paquetes, pero en vez de npm usa **GitHub como registro**. Para probarlo: ```shell npx skills add abr4xas/skills ``` Eso instala las skills de mi repo [abr4xas/skills](https://github.com/abr4xas/skills) en tu agente. ## Qué es una skill (en una línea) Una *skill* es un procedimiento reutilizable que tu agente carga solo cuando lo necesita: un archivo `SKILL.md` con frontmatter (`name`, `description`) y las instrucciones para una tarea concreta. Le enseñas algo una vez y deja de necesitar que se lo expliques en cada sesión. Si quieres el detalle de cómo se estructura y cuándo crearlas, eso da para su propio tema; aquí el foco es **cómo distribuirlas e instalarlas**. ## Instalar skills con npx skills El comando central es `add`, apuntando a un repo `usuario/repo` de GitHub. Instalar todas las skills de un repo: ```shell npx skills add abr4xas/skills ``` Instalar solo una skill concreta: ```shell npx skills add abr4xas/skills --skill answer-reviewers ``` Instalar en un agente específico (la tabla del repo lista más de 70: Claude Code, Cursor, OpenCode, Codex, Cline, Continue y siguen): ```shell npx skills add abr4xas/skills -a claude-code ``` Por debajo, la herramienta trae el `SKILL.md` del repo y lo **enlaza** (symlink) en el directorio de configuración de tu agente. Enlazar y no copiar es lo que hace que `npx skills update` sirva de algo. Si prefieres una copia independiente, está el flag `--copy`. ## Instalar una skill de forma global o solo en un proyecto Esta es la parte que más confunde, porque el comportamiento por defecto no es el que mucha gente espera. **`add` instala en el proyecto actual**, en `.//skills/`. Es decir, la skill vive con ese repo y no la tienes en el resto de tus proyectos. Para instalarla en tu directorio de usuario y tenerla disponible en todos: ```shell npx skills add abr4xas/skills -g ``` Con `-g` (o `--global`) va a `~//skills/`. La regla práctica es la misma que con las skills escritas a mano: global para tu forma de trabajar, proyecto para las convenciones de ese repo, que además se versionan con él. ## Los demás comandos de la CLI `add` es el que más se usa, pero no es el único: | Comando | Para qué | | --- | --- | | `npx skills add ` | Instala skills de un repo | | `npx skills list` (o `ls`) | Lista las que ya tienes instaladas; con `-g`, solo las globales | | `npx skills find ` | Busca skills; con `--owner ` filtras por organización | | `npx skills update [skills]` | Actualiza las instaladas (`-g` global, `-p` proyecto) | | `npx skills remove [skills]` (o `rm`) | Las desinstala | | `npx skills use ` | Las usa sin instalarlas | | `npx skills init [nombre]` | Genera una plantilla de `SKILL.md` para empezar la tuya | `use` es el que más se pasa por alto: prueba una skill de un repo ajeno sin dejar nada en tu configuración, que es justo lo que quieres antes de decidir si la instalas. ## Ejemplo real: mi repo abr4xas/skills Mantengo mi propio repo de skills, [abr4xas/skills](https://github.com/abr4xas/skills) (licencia MIT), con varias skills listas para usar. La que mejor sirve de ejemplo: - **`answer-reviewers`**: responde a comentarios de PR y resuelve *review threads* desde la terminal, usando el CLI `gh`. Sirve para atender feedback de revisión de código (por ejemplo, responder a un bot como coderabbitai) sin salir a la interfaz web de GitHub. Requiere `gh` autenticado y `jq`, y correrla dentro del repo, o definir la variable `GITHUB_REPO`. Es un buen ejemplo de para qué brillan las skills: un flujo repetible y con pasos concretos (leer el comentario, responder, resolver el hilo) que no quieres reexplicarle al agente cada vez. ## Publica tus propias skills Como el registro es GitHub, compartir las tuyas es tan simple como tener un repo público: 1. Crea un repo con una carpeta por skill, cada una con su `SKILL.md`. 2. Súbelo a GitHub como repositorio público. 3. Cualquiera las instala con `npx skills add tu-usuario/tu-repo`. No hay que publicar en ningún registro central ni pasar por revisión: el repo *es* el paquete. Eso baja muchísimo la fricción para versionar y compartir tu setup con tu equipo o con la comunidad. Es justo lo que hago con [abr4xas/skills](https://github.com/abr4xas/skills): las skills que uso a diario, versionadas e instalables por cualquiera. ## Dónde encaja esto Las skills son una pieza más del ecosistema de Claude Code, junto al `CLAUDE.md`, los subagentes y los servidores MCP. Si estás armando tu setup, te sirve el panorama completo: - La [guía de Claude Code](/guia-claude-code): todas las piezas y cómo encajan. - [Qué poner en tu CLAUDE.md](/post/claude-md-buenas-practicas): las reglas del proyecto que el agente respeta. - [Subagentes en Claude Code](/post/subagentes-claude-code): repartir tareas grandes sin ensuciar tu contexto. - [Mis skills para agentes de código](/tools/skills): las que mantengo abiertas, con qué resuelve cada una, por si quieres probarlas antes de escribir la tuya. ## Preguntas frecuentes ### ¿Qué es npx skills? Un gestor de skills para agentes de IA creado por Vercel Labs. Instala skills desde repositorios de GitHub en tu agente (Claude Code, Cursor y otros) con un comando, usando GitHub como registro en lugar de npm. ### ¿Necesito instalar algo antes? No. Con `npx` se ejecuta sin instalación global: `npx skills add usuario/repo` descarga y aplica las skills directamente. Solo necesitas Node.js; el `package.json` de `skills` pide la 22.20 o posterior. ### ¿Es `npm skills` o `npx skills`? Es **`npx`**. `npm` instala paquetes; `npx` ejecuta el binario de un paquete sin instalarlo, que es justo lo que quieres aquí. No hace falta instalar `npx` por separado: viene incluido con npm desde la 5.2 (Node.js 8.2), así que si tienes `node`, ya lo tienes. Y si prefieres el comando suelto, `npm i -g skills` te deja `skills` directo, sin el `npx` delante. ### ¿Cómo instalo una skill de forma global? Con el flag `-g`: `npx skills add usuario/repo -g`. Sin él, `add` instala **solo en el proyecto actual**, que es el comportamiento por defecto y la causa más común de "la instalé y mi agente no la ve" cuando cambias de carpeta. ### ¿Cómo veo las skills que tengo instaladas? `npx skills list` (o su alias `ls`). Con `-g` te muestra solo las globales y con `-a ` filtras por agente. ### ¿Funciona solo con Claude Code? No. Soporta varios agentes (Claude Code, Cursor, OpenCode, Codex y más). Puedes elegir el destino con el flag `-a`, por ejemplo `-a claude-code`. ### ¿Cómo comparto mis propias skills? Ponlas en un repo público de GitHub, una carpeta por skill con su `SKILL.md`. Cualquiera las instala con `npx skills add tu-usuario/tu-repo`. El repo funciona como el paquete, sin registro central. --- ## Sitemap Índice completo del sitio: [/sitemap.md](https://www.angelcruz.dev/sitemap.md) Canónico HTML: [https://www.angelcruz.dev/post/npx-skills](https://www.angelcruz.dev/post/npx-skills)