클로드 코드(Claude Code)를 좀 깊이 파다 보면 비슷해 보이는 두 단어가 자꾸 나옵니다. 바로 Plugin과 Skill입니다. 둘 다 클로드의 기능을 늘려 주는 확장이라 헷갈리기 쉬운데, 막상 사용해 보면 설치 방법도 다르고 동작 방식도 다릅니다. 이 글에서는 Plugin과 Skill이 정확히 무엇인지, 어떻게 다른지, 그리고 언제 어떤 것을 골라 써야 하는지를 한 번에 정리해 드립니다.
목차
한눈에 보는 Plugin vs Skill
먼저 핵심만 짧게 비교해 두고 시작합니다.
| 구분 | Skill | Plugin |
|---|---|---|
| 단위 | 단일 기능 모듈 | 여러 요소를 묶은 패키지 |
| 핵심 파일 | SKILL.md + 보조 리소스 | Skills·슬래시 커맨드·MCP 서버 등 묶음 |
| 설치 위치 | ~/.claude/skills/ 또는 .claude/skills/ | 마켓플레이스에서 /plugin install |
| 호출 방식 | 설명 기반 자동 트리거 + 슬래시 명령 | 설치 시 포함된 명령·스킬 함께 활성화 |
| 배포 채널 | 폴더 복사·Git 클론 | Plugin Marketplace |
| 호환성 | Agent Skills 표준 (Codex·Cursor 등 공통) | Claude Code 환경 중심 |
한 줄 요약하시면, Skill은 부품, Plugin은 그 부품들을 조립해 둔 완제품 박스에 가깝습니다.
Skill: 한 가지 일을 잘하게 만드는 부품
Skill은 클로드에게 “어떤 작업을 어떻게 처리할지”를 알려 주는 재사용 가능한 지침 묶음입니다. 핵심은 SKILL.md 파일 한 개입니다. 이 파일 안에 언제 이 스킬을 켜야 하는지(트리거 조건)와 어떤 절차로 작업을 진행하는지가 적혀 있습니다. 필요하면 같은 폴더에 보조 스크립트, 템플릿, 참고 문서를 함께 둘 수 있습니다.
구조는 단순합니다.
my-skill/폴더 안에SKILL.md를 둡니다.- 필요한 보조 파일(파이썬 스크립트, JSON 템플릿 등)을 같은 폴더에 둡니다.
- 이 폴더를
~/.claude/skills/(전 프로젝트 공통)나.claude/skills/(현재 프로젝트만)에 복사합니다.
설치 후에는 두 가지 방식으로 호출됩니다. 먼저 클로드가 사용자 요청과 SKILL.md의 설명을 매칭해 자동으로 켜는 방식이 있고, 사용자가 /skill-name처럼 슬래시 명령으로 직접 부르는 방식도 있습니다. 자동 트리거를 잘 받으려면 SKILL.md 상단의 description을 구체적으로 적어 두시는 것이 중요합니다.
또 하나 짚어 둘 점은 Skill 표준이 Claude만의 것이 아니라는 점입니다. Agent Skills 사양은 개방형이라, 잘 작성된 SKILL.md는 OpenAI Codex CLI, Cursor, GitHub Copilot 등 다른 AI 코딩 도구에서도 그대로 동작하도록 설계되어 있습니다. 한 번 만들어 두면 환경을 바꿔 가며 재활용할 수 있다는 뜻입니다.
Plugin: 부품들을 조립한 완제품
Plugin은 Skill보다 한 단계 큰 단위입니다. 하나의 Plugin 안에는 여러 개의 Skill, 슬래시 커맨드, MCP 커넥터(외부 서비스 연결), 훅(특정 시점에 자동 실행되는 동작) 같은 요소가 묶여서 한 번에 설치됩니다. 예를 들어 “코드 리뷰” Plugin 하나를 깔면, 리뷰용 슬래시 명령과 관련 스킬, 깃허브 연동까지 한꺼번에 따라옵니다.
가장 큰 차이는 배포 채널에 있습니다. Plugin은 마켓플레이스를 통해 검색·설치하는 구조가 정식으로 마련되어 있습니다. 공식 마켓플레이스 외에 커뮤니티가 운영하는 마켓플레이스도 추가해서 쓸 수 있습니다.
설치 방법은 클로드 코드 세션 안에서 슬래시 명령으로 진행합니다.
- 마켓플레이스 추가:
/plugin marketplace add 저장소경로 - 플러그인 검색·설치:
/plugin으로 브라우저를 열거나/plugin install 플러그인이름 - 설치 범위 선택: User(모든 프로젝트) 또는 Project(현재 저장소만)
- 설치 확인:
/plugin list --installed
프로젝트 단위로 고정해서 쓰고 싶으시면 .claude/settings.json에 직접 적어 두는 방법도 있습니다. 다음과 같은 형태입니다.
{ "plugins": ["code-review", "commit-commands"] }
이렇게 적어 두면 그 디렉터리에서 클로드 코드를 시작할 때 자동으로 함께 로드됩니다. 팀 단위로 같은 도구 세트를 공유할 때 편리한 방식입니다.
둘은 어떻게 연결되어 있나
두 개념이 헷갈리는 진짜 이유는 Plugin이 Skill을 포함할 수 있기 때문입니다. Plugin은 Skill 한두 개에 슬래시 커맨드와 외부 연동을 더해 만든 패키지라고 생각하시면 정리가 쉽습니다.
- Skill은 “이 작업은 이렇게 처리한다”는 절차적 지식의 단위입니다.
- Plugin은 그런 Skill 여러 개에 사용자가 부르기 좋은 명령과 외부 데이터 연결까지 묶어 놓은 배포 단위입니다.
그래서 똑같이 “/review-pr 커맨드 하나”가 동작해도, 그 뒤에는 SKILL.md 한 개만 있을 수도 있고 Plugin이 통째로 깔려 있을 수도 있습니다. 사용자 입장에서는 결과가 비슷해 보이지만 관리 단위는 전혀 다릅니다.
나는 뭘 써야 할까
본인 상황에 맞춰 고르시면 됩니다.
- 나 혼자 쓸 작은 자동화가 필요하다 → Skill 하나 만들어
~/.claude/skills/에 둡니다. - 여러 AI 도구에서 같은 흐름을 재사용하고 싶다 → 표준 Skill로 작성합니다. Codex·Cursor에서도 공유됩니다.
- 팀 단위로 같은 명령·도구 세트를 공유하고 싶다 → Plugin을 만들거나, 마켓플레이스에서 검증된 Plugin을 받아
.claude/settings.json에 고정합니다. - 외부 시스템(깃허브·DB·슬랙 등) 연동까지 한 번에 필요하다 → Plugin 쪽이 자연스럽습니다. MCP 커넥터를 함께 묶어 배포할 수 있기 때문입니다.
- 새로운 도구 한두 가지를 빠르게 시도해 보고 싶다 → 마켓플레이스의 Plugin부터 설치해 보시는 편이 빠릅니다.
실무 흐름에서는 두 가지를 같이 쓰는 경우가 흔합니다. 자주 쓰는 핵심 도구는 Plugin으로 깔아 두고, 본인 팀에만 의미 있는 작은 자동화는 Skill로 직접 만들어 사용하는 식입니다.
설치 직후 확인하면 좋은 것
Skill이든 Plugin이든 설치만 하면 끝이 아닙니다. 잘 동작하는지 확인하시는 것이 좋습니다.
- Plugin 설치 확인:
/plugin list --installed로 활성 상태와 출처 확인 - Skill 인식 확인: 새 세션을 시작한 뒤 관련 키워드로 요청해 자동 트리거가 걸리는지 확인
- 슬래시 명령 충돌: 같은 이름의 명령이 두 개 이상 깔려 있으면 어떤 게 먼저 실행될지 모릅니다. 이름 충돌은 미리 정리하시는 편이 안전합니다.
- 출처 신뢰도: 커뮤니티 마켓플레이스 Plugin은 외부 도구를 호출하거나 파일을 수정할 수 있으므로, SKILL.md와 코드를 한 번 훑어보고 설치하시는 것을 권해 드립니다.
자주 묻는 질문
Plugin과 Skill 중 뭐가 더 좋은가요?
좋고 나쁨의 문제가 아니라 단위의 차이입니다. Skill은 가장 작은 단위 부품이고 Plugin은 그 부품들을 묶은 패키지입니다. “도구 한 가지만 추가” 목적이면 Skill, “도구 세트 + 외부 연동까지 한 번에” 목적이면 Plugin이 자연스럽습니다.
Plugin을 깔면 그 안의 Skill만 따로 쓸 수 있나요?
Plugin 단위로 활성/비활성이 묶여 있는 것이 일반적입니다. 일부만 떼서 쓰고 싶다면 해당 Skill을 별도로 받아 본인의 ~/.claude/skills/에 두는 방식이 더 깔끔합니다.
이미 있는 MCP 서버는 Plugin과 어떻게 다른가요?
MCP 서버는 외부 도구·데이터로 가는 “통로” 자체이고, Plugin은 그 MCP 서버에 연결하는 설정과 사용 시점을 알려 주는 Skill·명령까지 함께 묶어 둔 것입니다. Plugin 안에 MCP 커넥터가 포함되어 있는 형태라고 보시면 됩니다.
회사 정책상 외부 마켓플레이스를 못 쓰면 어떻게 하나요?
두 가지 방법이 있습니다. 첫째는 사내 Git 저장소를 마켓플레이스로 등록해 내부 Plugin만 유통하는 방식, 둘째는 Skill을 직접 작성해 .claude/skills/에 두고 Git으로 공유하는 방식입니다. 후자는 별도 마켓플레이스 없이도 동작하므로 보안 정책이 엄격한 환경에서 자주 쓰는 패턴입니다.
정리
Skill은 클로드에게 한 가지 일을 잘 시키는 가장 작은 단위, Plugin은 그런 Skill 여러 개에 명령과 외부 연동까지 묶어 마켓플레이스로 유통할 수 있게 만든 단위입니다. 본인 작업이 작고 단순하면 Skill부터 시작하시고, 팀과 공유하거나 외부 시스템까지 묶어 써야 한다면 Plugin으로 묶는 흐름이 자연스럽습니다. 두 개념의 위치만 정확히 잡아 두시면 클로드 코드의 확장 생태계가 한층 명확하게 보입니다.