Skillcp

はい、スキルとMCPサーバーはすでにポータブルです。主要なハーネスはどれも、それらを別のフォルダとJSON形式に隠しているだけです。Skillcpは、欠けているライブラリです。各スキルとMCPサーバーのコピーを1つ持ち、使用するすべてのハーネスに公開します。

これはCLI、MCPサーバー、Agent Skill、ローカルWeb UIを兼ねているため、Cursor、Claude Code、Copilot、Codex、Gemini CLI、Windsurf、OpenCode、Cline、Claude Desktop、Piのすべてから操作できます。あるいはブラウザでライブラリを管理することもできます。

機能

1. ~/.skillcp に正規ライブラリを保持

   • スキルは標準の SKILL.md パッケージとして（~/.skillcp/skills/<name>/）

   • MCPサーバーは1つの mcp.json として（~/.skillcp/mcp.json）

2. Cursor、Claude、Copilot、その他で既に設定したものをインポート

3. そのライブラリを同期して書き戻す：

   • スキルは各製品のスキルディレクトリにシンボリックリンク（OSがリンクをブロックする場合はコピー）される

   • MCPサーバーは、無関係な設定を上書きせずに各製品のネイティブな設定形式にマージされる

同期後、同じGitHub MCPサーバーと同じ code-review スキルがすべてのハーネスに表示されます。

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サーバーとして登録され、検出されたハーネスにすべてが書き戻されます。

日常的な使い方

# 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

任意のハーネスから使用する（プラグイン）

skillcp install は以下を追加します：

• skillcp Agent Skill（モデルがいつ使うべきかを把握できるように）

• skillcp MCPサーバー（stdio上の skillcp serve）

MCP対応のハーネスはどれでも、5つの設定ファイルを手で編集する代わりに、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サーバーを登録し、スキルを提供し、コマンド（Open UI、Sync、Import、Status）を追加します。

Claude Code

このリポジトリはClaude Codeプラグイン（/.claude-plugin/plugin.json）です。次のようにして有効化します：

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

MCPサーバーが接続されていない場合でも、エージェントはCLIを実行できます。ブラウザGUIの場合は skillcp ui を実行してください。同梱のスキル skills/skillcp/SKILL.md に両方の方法が記載されています。

Web UI

skillcp ui

小さなローカルWebサーバー（デフォルトは http://127.0.0.1:8787）を起動し、ブラウザで開きます。そこからスキルの作成・編集・削除、MCPサーバーの追加、インストール済みハーネスからのインポート、ライブラリの同期書き戻しができます。localhostのみにバインドされます。

skillcp ui --port 9000 --no-open

対応ハーネス

MCP変換は実際の形式の差異をカバーします：mcpServers と servers、OpenCodeの mcp、Codex TOMLの mcp_servers、さらにGeminiの httpUrl と url の違いも対応します。

PiにはネイティブのMCPがありません。それでもSkillcpはPiのエージェントディレクトリに 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

同期は追加型です。ハーネスが既に持っていた余分なMCPサーバーはそのまま残されます。Skillcpが管理していてライブラリから削除されたサーバーは、次の同期時にハーネスファイルから削除されます（skill rm / mcp rm の直後にも削除されます）。--force はSkillcpのシンボリックリンクではないスキルフォルダを置き換えます。rm の --keep はハーネス側のコピーをそのまま残します。

プロジェクト vs グローバル

デフォルトの同期はユーザーグローバルです。つまり、開くすべてのリポジトリで同じ個人用スキルとMCPサーバーが使えます。

--project はチーム共有の設定としてカレントワーキングディレクトリに書き込みます。チーム全体で使う場合は、それらのファイルをコミットしてください。

シークレット

Skillcpはenv値を書き換えたり暗号化したりしません。トークンを貼り付ける代わりに、mcp.json では環境変数参照（$GITHUB_TOKEN）を推奨します。~/.skillcp/backups 配下のバックアップには、ハーネスファイルに元々あった内容がそのまま含まれます。

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値を書かれたままコピーします。$ENV_NAME を推奨）

• すべてのエディタをカバーする（Amp、Roo、Continue、Zed、Goose、Crushなど）。新しいホストが必要なら、小さなアダプターを追加すれば済みます。

skill rm と mcp rm は、デフォルトで検出されたハーネスから同期解除します。--keep を渡すとそれらのコピーを残します（シンボリックリンクだったスキルは、動作し続けるように先にコピーされます）。

引数なしの skillcp は、短いステータスと重要な2つのコマンド（ui と sync）を表示します。

開発

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

Node 20以上が必要です。