스킬·플러그인·MCP 서버의 차이와 쓰는 상황

스킬은 머리말에 name과 description이 있고 그 뒤에 지침이 이어지는 SKILL.md 파일이 들어 있는 디렉터리입니다. 참고 파일과 스크립트가 포함될 수 있습니다. 에이전트는 세션 시작 시 description만 읽고, 요청이 맞으면 전체 파일을 불러와 따릅니다. 형식이 공개되어 클로드 코드, 커서, 코덱스, 제미나이 CLI, 깃허브 코파일럿이 함께 쓰므로 GitHub의 스킬 하나가 npx skills add로 전부에 설치됩니다.

스킬은 모델에 새 능력을 주지 않습니다. 스스로 데이터베이스나 브라우저에 닿을 수 없습니다. 바꾸는 것은 판단과 절차입니다. diff를 어떻게 검토할지, 랜딩페이지에서 하지 말아야 할 것, 버그를 고쳤다고 하기 전에 밟을 단계. 비용은 설치된 스킬마다 매 턴 설명 한두 줄, 그리고 발동할 때 파일 전체입니다.

my-skill/
  SKILL.md        # frontmatter: name, description; then instructions
  reference.md    # optional
  scripts/        # optional, runs with your permissions

클로드 코드에서 플러그인은 .claude-plugin/plugin.json 매니페스트가 있는 저장소로, 슬래시 명령, 하위 에이전트 정의, 훅, MCP 서버 설정, 스킬을 함께 담을 수 있습니다. /plugin marketplace add 소유자/저장소로 마켓플레이스를 추가하고 /plugin install 이름@마켓플레이스로 설치합니다. 플러그인 자체는 실행 시 아무것도 하지 않습니다. 안에 든 것들을 배포하고 버전 관리하는 단위입니다.

이 단어는 클로드 코드 전용입니다. 커서는 비슷한 것을 확장과 규칙이라고 부르고, 제미나이 CLI에는 확장이 있으며, 코덱스는 이런 게 없이 스킬과 AGENTS.md를 직접 읽습니다. 플러그인 안에 스킬이 들어갈 수 있으니 "플러그인이냐 스킬이냐"는 대개 잘못된 질문입니다. 스킬이 내용이고 플러그인은 그것을 담는 상자입니다. 비용은 담긴 것의 합이며, 훅은 이벤트마다 자동으로 실행되므로 설치 전에 그 부분을 읽어야 합니다.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official

MCP 서버는 stdio나 HTTP로 Model Context Protocol을 말하는 별도 프로그램으로, 도구(에이전트가 부를 수 있는 함수), 리소스(읽을 수 있는 데이터), 프롬프트를 제공합니다. 에이전트 설정에 등록합니다. 클로드 코드는 .mcp.json이나 claude mcp add, 커서는 .cursor/mcp.json, 코덱스는 ~/.codex/config.toml, 제미나이 CLI는 settings.json. 연결되면 에이전트가 Postgres에 질의하고, 브라우저를 조작하고, Linear 티켓을 읽고, 내부 API를 부를 수 있습니다. 마크다운 파일로는 할 수 없는 일들입니다.

비용의 성격이 다릅니다. 연결된 모든 서버의 도구 정의가 매 턴 전송되므로 도구 40개짜리 서버는 아무것도 입력하기 전에 수천 토큰을 씁니다. 그리고 내 자격 증명으로 내 컴퓨터에서 도는 코드이므로 다른 의존성만큼 따져 봐야 합니다.

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/app

세 가지에, 사람들이 스킬과 가장 자주 혼동하는 상시 지침 파일(CLAUDE.md, AGENTS.md, GEMINI.md, 커서 규칙)까지 더해 표로 압축했습니다.

                  Skill              Plugin (Claude Code)      MCP server             Rules file
----------------  -----------------  ------------------------  ---------------------  ---------------------
What it is        SKILL.md folder    Manifest + bundled parts  Separate process       CLAUDE.md / AGENTS.md
Gives the agent   Procedure, taste   Distribution, versioning  New tools and data     Standing constraints
Loaded            When task matches  Parts load by their rule  Tool list every turn   Every turn
Token cost idle   ~1 line each       Sum of contents           Hundreds to thousands  Whole file
Works in          All major agents   Claude Code only          All major agents       Per agent, own name
Install           npx skills add     /plugin install           Config file entry      Commit the file
Can run code      Only via scripts   Hooks run automatically   Yes, that is the job   No
Read before use   SKILL.md, scripts  Hooks, MCP entries        Source, permissions    The file

문제가 "에이전트가 방법을 모른다"이면 스킬입니다. 코드 뒤에 테스트를 쓰고, 뻔한 화면을 만들고, 사소한 지적만 하는 것. 숙련된 동료가 절차를 설명해서 고칠 수 있는 일은 전부 스킬입니다. 가장 싸고, 어디서나 되고, 설치 전에 전부 읽어 볼 수 있습니다.

문제가 "에이전트가 할 수 없다"이면 MCP 서버입니다. 운영 로그를 읽거나, 질의를 실행하거나, 브라우저를 열거나, 티켓을 만들어야 할 때. 그 능력이 이미 셸에서 부를 수 있는 CLI로 있다면 MCP가 아예 필요 없을 수 있습니다. CLI 사용법을 설명하는 스킬이 더 가볍습니다.

클로드 코드에서 팀에 배포하는데 지침 이상이 필요하면 플러그인입니다. 편집마다 포매터를 돌리는 훅, 자체 모델을 쓰는 하위 에이전트, 미리 설정된 MCP 서버, 그리고 그것들을 쓰는 스킬. 설치 한 번, 버전 번호 하나.

제약이 짧고 항상 참이면 규칙 파일입니다. 패키지 관리자, 브랜치 이름 규칙, 커밋 메시지 언어. 규칙 파일이 한 화면을 넘어가면 긴 부분은 절차이니 스킬로 옮기세요.

지식을 위해 MCP 서버를 설치하기. 요청하면 문서를 돌려주는 "리액트 모범 사례" MCP 서버는 매 턴 도구 정의 비용을 내고 네트워크 왕복을 더합니다. 같은 내용을 스킬로 두면 필요할 때 디스크에서 한 번 올라옵니다.

스킬 30개를 한꺼번에 설치하기. 각각이 매 턴에 설명 한 줄을 더하고, 설명이 겹치는 스킬끼리는 경쟁합니다. 에이전트가 하나를 고르는데 어느 것인지 보이지 않습니다. 실제로 쓸 몇 개만 설치하고 나머지는 끄거나 지우세요.