Skillcp

是的。技能和 MCP 服务器本就具备可移植性——每个主流 harness 只是把它们藏在不同的文件夹和 JSON 结构中而已。Skillcp 正是缺失的那块拼图：每份技能和 MCP 服务器只需一份副本，即可发布到你使用的每一个 harness。

它是一个 CLI、一个 MCP 服务器、一个 Agent 技能，也是一个本地 Web UI，因此 Cursor、Claude Code、Copilot、Codex、Gemini CLI、Windsurf、OpenCode、Cline、Claude Desktop 和 Pi 都可以驱动它——你也可以在浏览器中管理整个库。

它的功能

1. 在 ~/.skillcp 中维护一个规范库

   • 技能以标准 SKILL.md 包的形式存放（~/.skillcp/skills/<name>/）

   • MCP 服务器以单个 mcp.json 存放（~/.skillcp/mcp.json）

2. 导入你在 Cursor、Claude、Copilot 及其他工具中已配置好的内容

3. 同步回该库：

   • 技能以符号链接（若操作系统阻止链接则复制）的方式写入每个产品的技能目录

   • MCP 服务器以合并方式写入每个产品的原生配置格式，不会覆盖无关设置

同步之后，同一个 GitHub MCP 服务器和同一个 code-review 技能会出现在每个 harness 中。

Related MCP server: Lab Registry Server

安装

npm install -g skillcp
skillcp --version

或者不安装直接运行：

npx skillcp

从代码检出运行：

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

首次运行：

skillcp init --import --install --sync

这会创建库、吸收现有的技能/MCP 配置、将 Skillcp 自身注册为技能和 MCP 服务器，并写回它检测到的所有 harness。

日常使用

# 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

从任意 harness 使用（插件）

skillcp install 会添加：

• skillcp Agent 技能（让模型知道何时使用它）

• skillcp MCP 服务器（通过 stdio 运行 skillcp serve）

任何支持 MCP 的 harness 都可以调用 skillcp_add_skill、skillcp_add_mcp、skillcp_import、skillcp_sync 和 skillcp_open_ui 等工具，而无需手动编辑五个配置文件。

本仓库同时也是这些 IDE 的原生插件：

Cursor / VS Code / Copilot / Windsurf

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

该扩展会注册 Skillcp MCP 服务器、贡献技能，并添加命令：打开 UI、同步、导入、状态。

Claude Code

本仓库是一个 Claude Code 插件（/.claude-plugin/plugin.json）。启用方式：

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

如果 MCP 服务器未连接，agent 仍可运行 CLI。如需浏览器 GUI，请运行 skillcp ui。随附的技能位于 skills/skillcp/SKILL.md，其中记录了这两种方式。

Web UI

skillcp ui

启动一个本地小型 Web 服务器（默认 http://127.0.0.1:8787）并在浏览器中打开。你可以在此创建、编辑和删除技能，添加 MCP 服务器，从已安装的 harness 导入，以及将库同步回去。它仅绑定到 localhost。

skillcp ui --port 9000 --no-open

支持的 harness

MCP 转换覆盖了真实的格式差异：mcpServers 与 servers、OpenCode 的 mcp、Codex TOML 的 mcp_servers，以及 Gemini 的 httpUrl 与 url。

Pi 没有原生 MCP；Skillcp 仍会在 Pi 的 agent 目录中写入 mcp.json，以便 pi-mcp-adapter（及类似扩展）能拾取相同的服务器。

多个宿主扫描的范围超出其自身的技能文件夹（Cursor 还会读取 Claude、Codex 和 .agents；Copilot 和 Gemini 读取 .agents；Pi 读取 .agents）。同步会将每个技能写入最少的文件夹，同时仍能覆盖每个产品，并移除会重复显示的残留 Skillcp 链接。MCP 配置按产品独立管理，不会以这种方式折叠。

skillcp harnesses 会打印你机器上的解析路径。

库的结构

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

同步是增量式的。harness 已有的额外 MCP 服务器会被保留。Skillcp 曾管理但已从库中移除的服务器会在下次同步时从 harness 文件中删除（skill rm / mcp rm 时立即删除）。--force 会替换非 Skillcp 符号链接的技能文件夹。rm 时使用 --keep 可保留 harness 中的副本。

项目级与全局级

默认同步为用户全局，因此你打开的每个仓库都会获得相同的个人技能和 MCP 服务器。

--project 会写入当前工作目录，用于团队共享配置。如果希望整个团队都获得这些文件，请将其提交。

密钥

Skillcp 不会重写或加密环境变量值。建议在 mcp.json 中使用环境变量引用（$GITHUB_TOKEN），而不是直接粘贴令牌。~/.skillcp/backups 下的备份会包含 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

我们刻意不做的事

Skillcp 保持为本地库加适配器。它不会：

• 在钥匙串中存储密钥（按原样复制环境变量值；建议使用 $ENV_NAME）

• 覆盖所有编辑器（Amp、Roo、Continue、Zed、Goose、Crush 等）。如果你需要，新宿主只需一个小的适配器。

skill rm 和 mcp rm 默认会取消检测到的 harness 的同步。传入 --keep 可保留这些副本（符号链接的技能会先被复制，以便继续正常工作）。

不带参数运行 skillcp 会打印简短状态和两个关键命令：ui 和 sync。

开发

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

需要 Node 20 或更高版本。