Skillcp

네, 스킬과 MCP 서버는 이미 이식 가능합니다. 모든 주요 하네스가 각자 다른 폴더와 JSON 형태로 숨겨 놓았을 뿐이죠. Skillcp는 그 누락된 라이브러리입니다: 각 스킬과 MCP 서버의 단일 사본을, 사용하는 모든 하네스에 배포합니다.

CLI이자 MCP 서버이자 Agent Skill이자 로컬 웹 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. 해당 라이브러리를 다시 동기화합니다:

   • 스킬은 각 제품의 스킬 디렉터리에 심링크(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를 지원하는 모든 하네스는 다섯 개의 구성 파일을 직접 편집하는 대신 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에 두 경로 모두 문서화되어 있습니다.

웹 UI

skillcp ui

작은 로컬 웹 서버(기본값 http://127.0.0.1:8787)를 시작하고 브라우저에서 엽니다. 여기서 스킬을 생성, 편집, 제거하고, MCP 서버를 추가하고, 설치된 하네스에서 가져오고, 라이브러리를 다시 동기화할 수 있습니다. localhost에만 바인딩됩니다.

skillcp ui --port 9000 --no-open

지원되는 하네스

MCP 변환은 실제 형식 차이를 처리합니다: mcpServers vs servers vs OpenCode mcp vs Codex TOML mcp_servers, 그리고 Gemini의 httpUrl vs 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를 실행하면 짧은 상태와 중요한 두 명령어(ui와 sync)를 출력합니다.

개발

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

Node 20+가 필요합니다.