Estudio de skills.sh y el CLI npx skills

skills.sh es el registro y leaderboard del ecosistema de agent skills (mantenido por Vercel Labs) y `npx skills` es su CLI: hace por las habilidades de tu agente lo que npm hizo por las dependencias de JavaScript — descubrir, instalar, versionar y compartir con un comando. La diferencia clave con npm: GitHub es el registro (no hay servidor de paquetes; cada skill es un repo con su SKILL.md).

Resumen con para qué y cómo, listo para tu OKF/Obsidian.

1 · Instalar una skill (formatos de origen)

# Formato corto GitHub (owner/repo)
npx skills add vercel-labs/agent-skills
# URL completa · GitLab · cualquier Git · ruta local
npx skills add https://github.com/vercel-labs/agent-skills
npx skills add ./my-local-skills

# Repo multi-skill: lista, selecciona, todas, no interactivo
npx skills add vercel-labs/agent-skills --list
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator
npx skills add vercel-labs/agent-skills --all
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

📦 No instalas nada de forma global: usas npx, siempre la última versión, por proyecto y seguro para equipos.

2 · Usar una skill sin instalarla (`npx skills use`)

Resuelve la skill, escribe en un directorio temporal y suelta el prompt por stdout. No toca .claude/skills/ ni el lockfile. Es el npx de las skills frente al npm install.

npx skills use vercel-labs/agent-skills@nextjs | claude
npx skills use vercel-labs/agent-skills --skill nextjs --agent claude-code

@skill = forma corta de --skill.
--agent arranca el agente con el prompt ya montado.
Gana a add en: probar antes de comprometerte, tareas puntuales, scripts/automatización.

3 · Encontrar la skill correcta

🏆 Leaderboard (skills.sh)

#	Skill	Repo	Instalaciones
1	find-skills	vercel-labs/skills	1,8M
2	frontend-design	anthropics/skills	477,7K
3	vercel-react-best-practices	vercel-labs/agent-skills	437,4K
4	microsoft-foundry	microsoft/azure-skills	355,4K
10	azure-storage	microsoft/azure-skills	352,9K

🔍 Buscador de terminal

npx skills find              # interactivo tipo fzf
npx skills find typescript

💡 Mira el leaderboard ANTES de buscar a ciegas: lo popular suele estar más pulido y mantenido. Las dos primeras (descubrir skills y diseño frontend) son transversales, no de nicho.

4 · Gestionar lo instalado (project/global, symlink, lockfile)

Comando	Qué hace
`npx skills list` / `ls -g`	Inventario (proyecto + global / solo globales)
`npx skills check`	Comprueba actualizaciones pendientes
`npx skills update` [nombre]	Actualiza todas o una concreta
`npx skills remove <nombre>`	Elimina una skill

📁 Project vs global

Project (por defecto): .claude/skills/ o .agents/skills/ — se versionan y se comparten con el equipo.
Global (-g): ~/ — en todos tus proyectos, solo para ti.

🔗 Symlink vs copy

Symlink (recomendado): una copia canónica única enlazada a cada agente → una fuente de verdad, actualizaciones triviales.
Copy: copias independientes por agente (cuando el entorno no soporta symlinks: algunos Windows, contenedores).

🔒 skills-lock.json = el lockfile (como package-lock.json): se genera al instalar la primera skill, se commitea, y permite reproducir el mismo conjunto + npx skills check. También fija versiones (seguridad).

5 · Publicar tu propia skill (sin formulario)

Crea una carpeta con tu SKILL.md y frontmatter (name y description obligatorios).
Súbela a un repositorio público de Git.
Comparte la URL: npx skills add tu-usuario/tu-repo.
La telemetría de instalación la coloca en el índice/leaderboard automáticamente.

npx skills init mi-skill     # genera la plantilla de un SKILL.md

🆔 Tu identidad en el registro es tu cuenta GitHub/GitLab (owner/repo). No hay squatting de nombres al estilo npm. ⚠️ Sin revisión: la calidad media es la que es — la curación recae en ti (instalaciones + mirar el repo).

6 · La parte incómoda: confianza y seguridad

Instalar una skill = instalar instrucciones (y a veces scripts ejecutables) que tu agente ejecutará con acceso a tu código. Trátala como una dependencia de npm que pide permisos de postinstall.

Criterio (del skill find-skills)	Regla
Instalaciones	Prefiere +1.000; cauto por debajo de 100
Estrellas del repo	<100 estrellas → escepticismo
Verificación	No recomiendes solo por resultados de búsqueda; abre el repo y mira `SKILL.md` y `scripts/`

🛡️ skills.sh añade páginas de análisis de seguridad (ej. con Snyk) y puedes pasar SkillSpector (analizador de NVIDIA) antes de instalar. El lockfile fija versiones: una actualización del repo NO entra sin tu npx skills update.

7 · Grafo animado — ciclo de vida de una skill

El token 🟠 recorre el flujo. Clic en el gráfico reinicia.

Iniciando…

8 · Comparativa manual vs CLI + alternativas

Aspecto	Manual	CLI
Velocidad	Copiar, pegar, ubicar	Un comando
Descubrimiento	A ciegas por GitHub	Leaderboard + buscador
Versionado	Inexistente	Lockfile + `skills check`
Multi-agente	Repetir por cada agente	Un comando para varios
Control del origen	Total	Bueno, requiere disciplina

🔀 Alternativas

Smithery CLI — skills y MCP en el mismo flujo: smithery skill search "code review".
claude-plugins.dev — instala plugins y skills de Claude Code en un comando; skills-installer para multi-cliente.
AI Tmpl (aitmpl.com) — catálogo de +900 componentes (skills, agentes, comandos, hooks, MCPs).

📦 Regla de librerías (local primero): revisar C:\Users\TUF\Documents\librerías\local\ antes de descargar. Relacionado con el OKF: este vault ya usa agent skills (.agents/skills/, .copilot/skills/). Fuente: https://www.webreactiva.com/blog/skills-sh.