6-1. 플러그인 — 만든 도구를 묶어서 나누기
스킬도 만들었고 CLAUDE.md도 세웠습니다. 마지막 조각은 플러그인(Plugin) — 만든 도구들을 한 묶음으로 포장해서 설치 한 번으로 나눠 갖는 방법입니다.
1. 스킬이 늘어나면 생기는 문제
지금 우리 프로젝트엔 스킬이 다섯 개 있습니다 — ① 가설, ② 수집, ③ 의심, ④ 정리, 그리고 넷을 굴리는 분석 파이프라인. 동료에게 주려면 다섯을 각각 복사해 줘야 하고, 고치면 또 다시 보내야 해요. 도구가 늘수록 나르는 일이 일이 됩니다.
플러그인은 스킬·설정·훅을 폴더 하나로 묶은 배포 단위입니다. 묶음에 이름과 버전이 붙고, 받는 사람은 명령 한 번으로 설치합니다.
2. 생긴 것 — 폴더 + 명세서 한 장
my-analysis-plugin/
├── .claude-plugin/
│ └── plugin.json ← 이름·설명·버전 (명세서)
└── skills/
├── 1-hypothesis/SKILL.md
├── 2-collect/SKILL.md
├── 3-suspect/SKILL.md
├── 4-report/SKILL.md
└── data-analysis-pipeline/SKILL.md
plugin.json에는 이름·설명·버전 세 줄이면 충분합니다. 우리가 모듈 2에서 만든 스킬 폴더를 그대로 skills/ 밑에 옮기면 — 그게 플러그인이에요. 코딩이 아니라 폴더 정리입니다.
3. 마켓플레이스 — 설치 한 번으로
플러그인을 받는 통로가 마켓플레이스입니다. Claude Code에서 /plugin을 입력하면 플러그인 관리자가 열려요.
둘러보기 — /plugin으로 공식 마켓플레이스의 플러그인 목록 탐색
마켓플레이스 추가 — /plugin marketplace add 깃허브주소로 커뮤니티·팀 마켓플레이스 등록
설치 — 목록에서 선택하면 끝. 스킬·설정이 한 번에 들어옴
마켓플레이스는 세 층위가 있습니다:
공식
Anthropic이 직접 선별한 플러그인. 모든 Claude Code에서 기본으로 탐색 가능
커뮤니티
전 세계 사용자가 제출하고 검토를 거친 플러그인. 주소 추가로 이용
팀 내부
우리 회사 git 저장소가 곧 마켓플레이스. 분석 도구 세트를 전사 표준으로 배포 가능
/plugin marketplace add team-datapopcorn/datapopcorn-analysis-plugin
/plugin install datapopcorn-analysis@datapopcorn
설치하면 /datapopcorn-analysis:2-collect처럼 부를 수 있고, 평소처럼 "CSV 전처리해줘"라고 말해도 알아서 꺼내 씁니다. 예전에 설치했다면 /plugin marketplace update datapopcorn으로 최신 버전을 받으세요. 소스를 열어 구조(.claude-plugin/ + skills/)를 그대로 보세요 — github.com/team-datapopcorn/datapopcorn-analysis-plugin
4. 언제 플러그인으로 묶나
| 스킬만으로 충분 | 플러그인으로 묶기 | |
|---|---|---|
| 쓰는 사람 | 나 혼자, 이 프로젝트 | 팀·여러 프로젝트 |
| 구성 | 스킬 한두 개 | 스킬 여러 개 + 설정 세트 |
| 업데이트 | 파일 직접 수정 | 버전 올리면 받는 쪽에 반영 |
순서도 이대로입니다 — 혼자 스킬로 실험하고, 쓸 만해지면 플러그인으로 묶어 나눕니다.
"플러그인을 사용하면 프로젝트와 팀 전체에서 공유할 수 있는 사용자 정의 기능으로 Claude Code를 확장할 수 있습니다."
— Claude Code 공식 문서 · 플러그인 만들기
5. 같이 해보기 — 내 스킬을 플러그인으로 배포하기
개념을 봤으니 직접 묶어 봅니다. 우리가 이 강의 플러그인을 만든 순서 그대로예요 — 코딩이 아니라 파일 두 장 쓰고 공개 저장소에 올리는 일입니다.
스킬 모으기 — 새 폴더에 skills/를 만들고, 만든 스킬 폴더(SKILL.md 포함)를 그 밑에 복사
명세서 두 장 — .claude-plugin/plugin.json(플러그인 정의)과 marketplace.json(배포 목록)을 작성
공개 저장소에 올리기 — 받는 사람이 설치하려면 공개 git 저장소여야 함. 회사 비공개 저장소면 배포용만 따로 공개로
받는 사람은 두 줄 — /plugin marketplace add 주소 → /plugin install 이름@마켓플레이스
명세서 두 장은 이렇게 생겼습니다. source: "./"는 "이 저장소 자체가 플러그인"이라는 뜻이에요.
// .claude-plugin/plugin.json
{ "name": "datapopcorn-analysis", "description": "...", "version": "2.0.0" }
// .claude-plugin/marketplace.json
{
"name": "datapopcorn",
"owner": { "name": "데이터팝콘" },
"plugins": [ { "name": "datapopcorn-analysis", "source": "./" } ]
}
이것도 Claude Code에게 맡기면 됩니다 — "이 스킬들 플러그인으로 묶고 마켓플레이스 명세서까지 만들어줘"라고 하면 폴더 구조와 두 장을 채워줘요. 우리가 만든 결과물이 바로 이 저장소입니다.
★ 핵심. 스킬이 개인의 작업 매뉴얼이라면, 플러그인은 팀에 배포하는 도구 세트입니다. 잘 만든 분석 파이프라인 하나가 설치 한 번으로 팀 전체의 기본기가 돼요.