Skillcp

Ja. Skills und MCP-Server sind bereits portabel – jede gängige Umgebung versteckt sie nur in einem anderen Ordner und JSON-Format. Skillcp ist die fehlende Bibliothek: eine Kopie jedes Skills und MCP-Servers, veröffentlicht in jeder Umgebung, die du verwendest.

Es ist ein CLI, ein MCP-Server, eine Agent-Skill und eine lokale Weboberfläche, sodass Cursor, Claude Code, Copilot, Codex, Gemini CLI, Windsurf, OpenCode, Cline, Claude Desktop und Pi es alle steuern können – oder du kannst die Bibliothek im Browser verwalten.

Was es tut

1. Verwaltet eine kanonische Bibliothek in ~/.skillcp

   • Skills als Standard-SKILL.md-Pakete (~/.skillcp/skills/<name>/)

   • MCP-Server als eine mcp.json (~/.skillcp/mcp.json)

2. Importiert, was du bereits in Cursor, Claude, Copilot und den anderen konfiguriert hast

3. Synchronisiert diese Bibliothek zurück:

   • Skills werden als Symlinks in das Skill-Verzeichnis jedes Produkts verknüpft (kopiert, falls das Betriebssystem Links blockiert)

   • MCP-Server werden in das native Konfigurationsformat jedes Produkts eingefügt, ohne unzusammenhängende Einstellungen zu überschreiben

Nach der Synchronisierung erscheinen derselbe GitHub-MCP-Server und dieselbe code-review-Skill in jeder Umgebung.

Related MCP server: Lab Registry Server

Installation

npm install -g skillcp
skillcp --version

Oder ohne Installation ausführen:

npx skillcp

Aus einem Checkout:

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

Erster Start:

skillcp init --import --install --sync

Das erstellt die Bibliothek, saugt vorhandene Skills-/MCP-Konfigurationen auf, registriert Skillcp selbst als Skill + MCP-Server und schreibt alles zurück in die erkannten Umgebungen.

Tägliche Nutzung

# 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

Nutzung aus jeder Umgebung (das Plugin)

skillcp install fügt hinzu:

• die skillcp-Agent-Skill (damit das Modell weiß, wann es sie verwenden soll)

• den skillcp-MCP-Server (skillcp serve über stdio)

Jede MCP-fähige Umgebung kann dann Tools wie skillcp_add_skill, skillcp_add_mcp, skillcp_import, skillcp_sync und skillcp_open_ui aufrufen, anstatt fünf Konfigurationsdateien von Hand zu bearbeiten.

Dieses Repository ist auch ein natives Plugin für die IDEs:

Cursor / VS Code / Copilot / Windsurf

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

Die Erweiterung registriert den Skillcp-MCP-Server, stellt die Skill bereit und fügt Befehle hinzu: Open UI, Sync, Import, Status.

Claude Code

Dieses Repository ist ein Claude-Code-Plugin (/.claude-plugin/plugin.json). Aktiviere es mit:

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

Wenn der MCP-Server nicht verbunden ist, können Agents weiterhin die CLI ausführen. Für eine Browser-GUI führe skillcp ui aus. Die mitgelieferte Skill unter skills/skillcp/SKILL.md dokumentiert beide Wege.

Web-UI

skillcp ui

Startet einen kleinen lokalen Webserver (Standard http://127.0.0.1:8787) und öffnet ihn in deinem Browser. Von dort aus kannst du Skills erstellen, bearbeiten und entfernen, MCP-Server hinzufügen, aus installierten Umgebungen importieren und die Bibliothek zurücksynchronisieren. Er bindet nur an localhost.

skillcp ui --port 9000 --no-open

Unterstützte Umgebungen

Die MCP-Konvertierung deckt die tatsächlichen Formatunterschiede ab: mcpServers vs. servers vs. OpenCode-mcp vs. Codex-TOML-mcp_servers, plus Geminis httpUrl vs. url.

Pi hat kein natives MCP; Skillcp schreibt trotzdem mcp.json in Pis Agent-Verzeichnis, damit pi-mcp-adapter (und ähnliche Erweiterungen) dieselben Server aufnehmen.

Mehrere Hosts durchsuchen mehr als nur ihren eigenen Skill-Ordner (Cursor liest auch Claude, Codex und .agents; Copilot und Gemini lesen .agents; Pi liest .agents). Sync schreibt jede Skill in die wenigsten Ordner, die trotzdem jedes Produkt erreichen, und entfernt übrig gebliebene Skillcp-Links, die doppelt erscheinen würden. MCP-Konfigurationen sind pro Produkt und werden nicht auf diese Weise zusammengeführt.

skillcp harnesses gibt die aufgelösten Pfade auf deinem Rechner aus.

Wie eine Bibliothek aussieht

~/.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

Sync ist additiv. Zusätzliche MCP-Server, die eine Umgebung bereits hatte, bleiben unangetastet. Server, die Skillcp verwaltet hat und die die Bibliothek verlassen haben, werden bei der nächsten Synchronisierung aus den Umgebungsdateien entfernt (und sofort bei skill rm / mcp rm). --force ersetzt Skill-Ordner, die keine Skillcp-Symlinks sind. --keep bei rm belässt die Kopien in der Umgebung.

Projekt vs. global

Die Standard-Synchronisierung ist benutzer-global, sodass jedes Repository, das du öffnest, dieselben persönlichen Skills und MCP-Server erhält.

--project schreibt in das aktuelle Arbeitsverzeichnis für ein teamweit geteiltes Setup. Committe diese Dateien, wenn das gesamte Team sie erhalten soll.

Geheimnisse

Skillcp schreibt Umgebungsvariablenwerte weder um noch verschlüsselt sie. Bevorzuge Umgebungsvariablen-Referenzen ($GITHUB_TOKEN) in mcp.json, anstatt Tokens einzufügen. Backups unter ~/.skillcp/backups enthalten das, was bereits in der Umgebungsdatei stand.

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

Was wir bewusst nicht tun

Skillcp bleibt eine lokale Bibliothek plus Adapter. Es:

• speichert keine Geheimnisse in einem Schlüsselbund (kopiert Umgebungsvariablenwerte wie geschrieben; bevorzuge $ENV_NAME)

• deckt nicht jeden Editor ab (Amp, Roo, Continue, Zed, Goose, Crush, …). Neue Hosts sind ein kleiner Adapter, falls du sie brauchst.

skill rm und mcp rm heben die Synchronisierung erkannter Umgebungen standardmäßig auf. Übergib --keep, um diese Kopien unangetastet zu lassen (Skills, die Symlinks waren, werden zuerst kopiert, damit sie weiterhin funktionieren).

skillcp ohne Argumente gibt einen kurzen Status und die beiden wichtigen Befehle aus: ui und sync.

Entwicklung

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

Node 20+ ist erforderlich.