Skillbase/spm

npm para habilidades de IA. Crea, comparte y descubre instrucciones de IA reutilizables para cualquier modelo a través de MCP.

GitHub

Documentación

Skillbase / spm

Skills Package Manager: instala, comparte y gestiona habilidades de IA reutilizables en cualquier cliente compatible con MCP.

¿Qué es spm?

spm es un gestor de paquetes para habilidades de IA. Las habilidades son instrucciones estructuradas — no código — que enseñan a los modelos de IA cómo realizar tareas específicas: revisión de código, auditorías de seguridad, diseño de APIs, ingeniería de prompts, análisis DeFi, y más.

npm install -g @skillbase/spm

spm se conecta a tu cliente de IA mediante MCP (Model Context Protocol), dándole a tu IA acceso a un registro de habilidades aportadas por la comunidad que se cargan bajo demanda.

A diferencia de los enfoques basados en npm que se apoyan en node_modules, spm tiene su propio registro, su propio formato, y funciona con cualquier cliente de IA — no solo editores de código.

¿Ya usas Vercel Skills? spm es totalmente compatible — spm add owner/repo/skill-name y listo. Conversión automática, sin pasos adicionales. Ver detalles abajo.

Inicio rápido

# Install
npm install -g @skillbase/spm

# Initialize in your project
spm init

# Connect to your AI client
spm connect claude       # Claude Desktop / Claude Code
spm connect cursor       # Cursor
spm connect vscode       # VS Code (Copilot)
spm connect windsurf     # Windsurf
spm connect jetbrains    # Any JetBrains IDE

# Install a skill
spm add skillbase/arch-code-review

# Install a persona (a bundle of skills with a defined role)
spm persona add skillbase/sec

Una vez conectado, tu IA descubre y carga habilidades automáticamente cuando encuentra una tarea que coincide. No se necesita invocación manual.

Cómo funciona

spm se registra como un servidor MCP. Tu cliente de IA obtiene cinco herramientas:

Herramienta	Propósito
`skill_list`	Explorar habilidades instaladas (índice compacto, no contenido completo)
`skill_load`	Cargar las instrucciones completas de una habilidad en el contexto
`skill_search`	Encontrar habilidades por palabra clave, etiqueta o patrón de archivo
`skill_install`	Instalar nuevas habilidades desde el registro
`skill_feedback`	Calificar la calidad de las habilidades (alimenta las puntuaciones de confianza)

La carga diferida es clave en el diseño. La IA ve un índice ligero de todas las habilidades instaladas. Cuando encuentra una tarea que coincide con el disparador de una habilidad, carga solo las instrucciones completas de esa habilidad. Esto mantiene las ventanas de contexto limpias y te permite instalar docenas de habilidades sin sobrecarga.

User: "Review this pull request for architecture issues"
  ↓
AI sees skill_list → finds arch-code-review (trigger matches)
  ↓
AI calls skill_load("arch-code-review")
  ↓
Full review methodology loads into context
  ↓
AI performs structured code review

¿Qué contiene una habilidad?

Una habilidad es un directorio. En su núcleo hay un archivo SKILL.md — Markdown estructurado con frontmatter YAML:

---
name: arch-code-review
version: 1.0.3
description: "Architecture-aware code review"
tags: [code-review, architecture, solid, complexity]
triggers:
  - "code review"
  - "architecture review"
  - "pull request review"
---

# Code Review Methodology

## Evaluation criteria
- Coupling/cohesion at module and class level
- SOLID principle adherence
- Cyclomatic complexity hotspots
...

Pero una habilidad no se limita a instrucciones. El directorio también puede contener scripts auxiliares, plantillas, archivos de ejemplo y cualquier otro recurso que la IA necesite durante la ejecución. Piensa en SKILL.md como package.json — es el punto de entrada, pero todo el directorio es el paquete.

Características de las habilidades

Versionado semver — skillbase/arch-code-review@1.0.3
Dependencias — las habilidades pueden depender de otras habilidades
Archivos auxiliares — scripts, plantillas, datos de referencia incluidos junto con las instrucciones
Disparadores — descripciones y patrones de archivo que ayudan a la IA a decidir cuándo cargar
Etiquetas — para búsqueda y descubrimiento
Puntuaciones de confianza — calculadas a partir de comentarios reales de usuarios mediante skill_feedback

Personas

Una persona agrupa múltiples habilidades en una identidad de IA completa con un rol, tono y área de especialización definidos.

spm persona add skillbase/sec

Esto instala la persona Security Auditor con sus dependencias: smart-contract-audit, appsec y web3-threat-modeling. Cuando se activa, la IA asume el rol de la persona y tiene acceso a todas las habilidades incluidas.

Personas disponibles:

Persona	Rol	Habilidades
`arch`	Arquitecto de software	diseño de sistemas, contratos de API, revisión de código
`py`	Ingeniero backend Python	FastAPI, async, pruebas, MongoDB/PostgreSQL
`ts`	Desarrollador fullstack TypeScript	React/Next/Nuxt, Node, Tailwind, wagmi
`sol`	Desarrollador Solidity/EVM	Foundry, OpenZeppelin, optimización de gas
`sec`	Auditor de seguridad	auditoría de contratos inteligentes, AppSec, modelado de amenazas
`trader`	Trader DeFi/cripto	análisis on-chain, estrategias de rendimiento, MEV
`growth`	Especialista en growth marketing	embudos, métricas, go-to-market Web3
`prompt-engineer`	Ingeniero de prompts	redacción de SKILL.md, mejores prácticas de prompts
`prompt-manager`	Gestor de prompts	investigación de demanda de habilidades, revisión de calidad

Sincronización de equipo

Skillbase Sync añade configuración a nivel de equipo y compartición de conocimiento sobre spm. Define un conjunto estándar de habilidades para tu proyecto — todos instalan con un solo comando.

# Link your repo to a Sync project
spm sync init

# Install everything the project requires
spm sync

# Check what's missing without installing
spm sync --status

Cuando Sync está conectado, tu agente de IA también obtiene acceso al conocimiento compartido del equipo — decisiones, restricciones y contexto capturados por compañeros. No más empezar desde cero cuando alguien más retoma una tarea.

Aprende más: Documentación de Sync

Registro

El registro aloja habilidades en varios dominios:

Desarrollo — python-backend, python-testing, db-mongodb, arch-code-review, arch-api-design, arch-system-design

Seguridad — appsec, smart-contract-audit, web3-threat-modeling, prompt-injection-detector, jailbreak-scanner, prompt-safety-validator

DeFi y Trading — yield-analysis, leverage-calc, onchain-signals, mev-awareness, trade-journal

Growth y Estrategia — defi-growth-strategy, growth-airdrop-design, web3-grant-writing

Meta — prompt-engineering-craft (aprende a escribir mejores prompts y habilidades)

Explora el registro completo: skillbase.space/explore

Compatibilidad con Vercel Skills

spm es totalmente compatible con Vercel Skills y cualquier habilidad alojada en GitHub que siga el mismo formato SKILL.md. No tienes que elegir — si una habilidad existe en GitHub, puedes usarla en spm.

Instalación directa — un comando, conversión e instalación automáticas:

spm add vercel-labs/agent-skills/web-design-guidelines

Eso es todo. spm obtiene la habilidad de GitHub, detecta el formato, lo convierte a SPM sobre la marcha y lo instala localmente. Listo para usar de inmediato — sin banderas, sin pasos adicionales.

O convierte primero, luego publica — si quieres revisar, editar y compartir con la comunidad:

# 1. Fetch and convert to a local directory
spm convert vercel-labs/agent-skills/web-design-guidelines -o ./

# 2. Review and edit SKILL.md if needed
# 3. Publish to the spm registry
spm publish ./web-design-guidelines

El autor por defecto es el propietario del repositorio de GitHub. Sobrescribe con --author <name> si es necesario. La bandera --skill <name> también es compatible como alternativa: spm add vercel-labs/agent-skills --skill web-design-guidelines.

Lo que spm añade sobre la habilidad original:

Característica	Vercel Skills	Con spm
Versionado	ninguno	semver (`1.0.0`)
Dependencias	no compatible	dependencias entre habilidades con resolución
Carga diferida	ninguna	bajo demanda vía MCP
Descubrimiento	manual	auto-disparo por tarea, etiquetas, patrones de archivo
Comentarios y puntuación	ninguno	puntuaciones de confianza por uso real
Soporte de clientes	editores seleccionados	cualquier cliente MCP (15+)
Personas	ninguna	agrupa habilidades en roles

También puedes listar todas las habilidades disponibles en un repositorio antes de instalar:

spm convert vercel-labs/agent-skills
# → lists all skills in the repo's skills/ directory

Funciona con cualquier repositorio de GitHub que contenga archivos SKILL.md — no se limita a los repositorios de Vercel.

Publica tu propia habilidad

Desde la CLI:

# Scaffold a new skill from scratch
spm create my-skill

# Or convert an existing prompt file
spm convert my-prompt.md --author myname

# Or import from GitHub (auto-converts Vercel Skills)
spm convert owner/repo/skill-name -o ./

# Edit SKILL.md, then publish
spm publish

Desde Skillbase Studio:

Skillbase Studio proporciona un editor visual para crear, probar, publicar e instalar habilidades — todo en el navegador. Studio se comunica con tu daemon local de spm para publicar e instalar directamente desde la interfaz.

Crea o importa una habilidad en Studio
Edita y prueba con el sandbox integrado
Haz clic en Publish — Studio envía el SKILL.md compilado a tu spm local, que gestiona la autenticación del registro y la subida
Haz clic en Install — instala la versión publicada localmente vía spm

Studio requiere que spm esté ejecutándose localmente (spm status-server start o haz clic en "Connect spm" en la interfaz). Toda la publicación usa tus credenciales existentes de spm login.

Las habilidades son gratuitas de publicar y de usar. El registro es abierto.

Clientes compatibles

spm funciona con cualquier cliente que soporte MCP:

Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, Cline, Roo Code, IDEs JetBrains (todos), Zed, OpenAI Codex, Emacs, Neovim, y otros.

# See all supported clients
spm connect --list

¿Por qué no usar simplemente npm?

Algunos proyectos agrupan habilidades de IA dentro de paquetes npm. spm adopta un enfoque diferente:

Registro propio — las habilidades son ciudadanos de primera clase, no un efecto secundario de npm install. Descubrimiento, búsqueda, versionado y puntuaciones de confianza están integrados.
No ligado a Node.js — las habilidades de spm funcionan con cualquier cliente de IA en cualquier plataforma. No necesitas una carpeta node_modules.
Carga diferida vía MCP — las habilidades se cargan en el contexto de la IA bajo demanda, no todas a la vez. Esto es crítico cuando tienes docenas de habilidades.
Bucle de comentarios — skill_feedback permite a los usuarios calificar habilidades. Las puntuaciones de confianza destacan las habilidades más efectivas.
Personas — agrupa habilidades en roles. npm no tiene este concepto.
Formato extensible — una habilidad puede crecer de instrucciones puras a incluir scripts, plantillas y datos sin cambiar cómo se instala o carga.
Compatible, no bloqueado — importa habilidades de Vercel Skills, GitHub o archivos de prompts locales. spm convert gestiona la conversión de formato automáticamente.

Seguridad

Todas las habilidades y personas en el registro público pasan por una revisión de seguridad antes de su publicación. Los archivos auxiliares incluidos con las habilidades se escanean con antivirus y herramientas de seguridad automatizadas adicionales. spm usa autorización con ámbito de token para publicar — solo autores verificados pueden actualizar sus paquetes.

El formato SKILL.md es Markdown plano con metadatos estructurados — no hay ejecución de scripts postinstall ni efectos secundarios ocultos.

Contribuciones

Damos la bienvenida a habilidades, informes de errores, solicitudes de funciones y mejoras de documentación.

Enlaces

skillbase.space — página principal de spm y registro
Skillbase Sync — compartición de conocimiento de equipo y configuración de proyectos
Skillbase Studio — editor visual para crear, probar y publicar habilidades
Skillbase Workspace — mercado para equipos de agentes de IA listos para usar; publica el tuyo y gana participación en ingresos por cada despliegue
Documentación
npm

Licencia

MIT — ver LICENSE.