Skillcp

Sí. Los skills y los servidores MCP ya son portables: cada harness importante simplemente los esconde en una carpeta y una forma JSON diferentes. Skillcp es la librería que faltaba: una copia de cada skill y servidor MCP, publicada en cada harness que uses.

Es una CLI, un servidor MCP, un Agent Skill y una interfaz web local, por lo que Cursor, Claude Code, Copilot, Codex, Gemini CLI, Windsurf, OpenCode, Cline, Claude Desktop y Pi pueden usarlo — o puedes gestionar la librería desde el navegador.

Qué hace

1. Mantiene una librería canónica en ~/.skillcp

   • Skills como paquetes estándar SKILL.md (~/.skillcp/skills/<name>/)

   • Servidores MCP como un único mcp.json (~/.skillcp/mcp.json)

2. Importa lo que ya tengas configurado en Cursor, Claude, Copilot y el resto

3. Sincroniza esa librería hacia fuera:

   • Los skills se enlazan simbólicamente (se copian si el sistema operativo bloquea los enlaces) en el directorio de skills de cada producto

   • Los servidores MCP se fusionan en el formato de configuración nativo de cada producto sin sobrescribir ajustes no relacionados

Tras la sincronización, el mismo servidor MCP de GitHub y el mismo skill code-review aparecen en todos los harness.

Related MCP server: Lab Registry Server

Instalación

npm install -g skillcp
skillcp --version

O ejecuta sin instalar:

npx skillcp

Desde un checkout:

npm install
npm run build
node dist/cli.js status

Primera ejecución:

skillcp init --import --install --sync

Eso crea la librería, recopila los skills/configuraciones MCP existentes, registra el propio Skillcp como skill + servidor MCP y escribe todo de vuelta en los harness que detecte.

Uso diario

# Browser GUI for the library
skillcp ui

# See what is installed where
skillcp status
skillcp doctor

# Add a skill from a folder or GitHub repo
skillcp skill add ./my-skill
skillcp skill add anthropics/skills --path pdf

# Add an MCP server once
skillcp mcp add github --command npx --args -y,@modelcontextprotocol/server-github --env GITHUB_TOKEN=$GITHUB_TOKEN
skillcp mcp add docs --url https://example.com/mcp --type http

# Publish the library to every detected harness (user-global)
skillcp sync

# Also write project files (.cursor/skills, .mcp.json, .vscode/mcp.json, …)
skillcp sync --project

# Only Cursor + Claude Code
skillcp sync --to cursor --to claude

Úsalo desde cualquier harness (el plugin)

skillcp install añade:

• el Agent Skill skillcp (para que el modelo sepa cuándo usarlo)

• el servidor MCP skillcp (skillcp serve sobre stdio)

Cualquier harness compatible con MCP puede entonces llamar a herramientas como skillcp_add_skill, skillcp_add_mcp, skillcp_import, skillcp_sync y skillcp_open_ui en lugar de editar cinco archivos de configuración a mano.

Este repositorio es también un plugin nativo para los IDEs:

Cursor / VS Code / Copilot / Windsurf

code --install-extension ./extensions/vscode
# or, in Cursor: Install from VSIX / install the folder as an extension

La extensión registra el servidor MCP de Skillcp, aporta el skill y añade comandos: Open UI, Sync, Import, Status.

Claude Code

Este repositorio es un plugin de Claude Code (/.claude-plugin/plugin.json). Actívalo con:

claude plugin install .
# or
claude --plugin-dir .

Si el servidor MCP no está conectado, los agentes pueden ejecutar igualmente la CLI. Para una interfaz gráfica en el navegador, ejecuta skillcp ui. El skill incluido en skills/skillcp/SKILL.md documenta ambas vías.

Interfaz web

skillcp ui

Inicia un pequeño servidor web local (por defecto http://127.0.0.1:8787) y lo abre en tu navegador. Desde ahí puedes crear, editar y eliminar skills, añadir servidores MCP, importar desde los harness instalados y sincronizar la librería hacia fuera. Solo se vincula a localhost.

skillcp ui --port 9000 --no-open

Harness compatibles

La conversión de MCP cubre la deriva real de formatos: mcpServers frente a servers, o el mcp de OpenCode frente al mcp_servers de Codex TOML, además del httpUrl frente a url de Gemini.

Pi no tiene MCP nativo; Skillcp aun así escribe mcp.json en el directorio de agente de Pi para que pi-mcp-adapter (y extensiones similares) detecten los mismos servidores.

Varios hosts escanean más que su propia carpeta de skills (Cursor también lee Claude, Codex y .agents; Copilot y Gemini leen .agents; Pi lee .agents). La sincronización escribe cada skill en el menor número de carpetas que sigan llegando a todos los productos, y elimina los enlaces de Skillcp sobrantes que aparecerían duplicados. Las configuraciones MCP son específicas de cada producto y no se fusionan de esta manera.

skillcp harnesses imprime las rutas resueltas en tu máquina.

Cómo se ve una librería

~/.skillcp/
  config.json          # symlink vs copy
  mcp.json             # canonical MCP servers
  manifest.json        # names Skillcp manages
  skills/
    code-review/SKILL.md
    skillcp/SKILL.md
  backups/             # copies of harness files before each MCP write

La sincronización es aditiva. Los servidores MCP adicionales que ya tuviera un harness se dejan intactos. Los servidores que Skillcp solía gestionar y que abandonaron la librería se eliminan de los archivos de los harness en la siguiente sincronización (e inmediatamente con skill rm / mcp rm). --force reemplaza las carpetas de skills que no son enlaces simbólicos de Skillcp. --keep en rm deja las copias de los harness en su sitio.

Proyecto frente a global

La sincronización por defecto es global de usuario, por lo que cada repositorio que abras recibe los mismos skills y servidores MCP personales.

--project escribe en el directorio de trabajo actual para una configuración compartida por el equipo. Haz commit de esos archivos si todo el equipo debería recibirlos.

Secretos

Skillcp no reescribe ni cifra los valores de entorno. Prefiere referencias a variables de entorno ($GITHUB_TOKEN) en mcp.json en lugar de pegar tokens. Las copias de seguridad en ~/.skillcp/backups contendrán lo que ya hubiera en el archivo del harness.

CLI

skillcp init [--import] [--install] [--sync]
skillcp status [--project]
skillcp doctor
skillcp import [--to cursor] [--all] [--project] [--overwrite]
skillcp sync [--to claude] [--all] [--project] [--dry-run] [--force] [--prune]
skillcp install [--no-sync]
skillcp serve
skillcp ui [--port 8787] [--host 127.0.0.1] [--no-open]
skillcp skill list|add|rm|show
skillcp skill rm <name> [--keep] [--project]
skillcp mcp list|add|rm|show
skillcp mcp rm <name> [--keep] [--project]
skillcp harnesses

Lo que deliberadamente no hacemos

Skillcp sigue siendo una librería local más adaptadores. No:

• Almacena secretos en un llavero (copia los valores de entorno tal cual; prefiere $ENV_NAME)

• Cubre todos los editores (Amp, Roo, Continue, Zed, Goose, Crush, …). Los nuevos hosts son un adaptador pequeño si los necesitas.

skill rm y mcp rm desincronizan los harness detectados por defecto. Pasa --keep para dejar esas copias intactas (los skills que eran enlaces simbólicos se copian primero para que sigan funcionando).

skillcp sin argumentos imprime un breve estado y los dos comandos que importan: ui y sync.

Desarrollo

npm install
npm test
npm run build
node dist/cli.js status

Se requiere Node 20+.