Claude Code 플러그인 — 내가 만든 스킬을 팀의 도구로

PEC · PRODUCT ENGINEERING

내가 만든 스킬을
팀의 도구로

Claude Code 플러그인 — 파일 복사 없이, 고치면 팀 전체에 바로 반영

BOAZ · 2026.07

02 도입

쓰다 보면 나만의 도구가 생깁니다

스킬

배포 스킬

우리 서비스 배포 절차를 그대로 밟아준다

에이전트

리뷰 에이전트

팀 컨벤션 기준으로 코드를 봐준다

문제는 이게 내 컴퓨터에만 있다는 것

03 오늘 다룰 것

공유 문제

플러그인으로 포장

자동 업데이트

04 Part 1 · 공유 문제

파일 복사로 공유하면
버전이 흩어지기 시작한다

내 컴퓨터 안

스킬 폴더에만 있다

~/.claude/skills/deploy/

슬랙으로 전송

팀원 5명

각자 복사본을 만든다

A · B · C · D · E — 사본 5개

스킬 파일을 슬랙으로 보내고 팀원 5명이 각자 복사한다

05 Part 1 · 공유 문제

일주일 뒤 내가 개선하면?

반복

다시 보내고 다시 복사

한 명은 복사를 까먹는다

결과

한 명은 까먹고 구버전을 쓴다

버그 제보가 들어왔는데 알고 보니 구버전 문제

06 Part 2 · 플러그인으로 포장

플러그인 = 내 스킬과 에이전트를
폴더 하나로 포장한 패키지

before

흩어져 있던 파일

스킬
에이전트
훅

폴더 하나로 포장

after

deploy-kit/

이름표를 붙인다 — plugin.json

plugin.json 이름표 하나 붙이면 준비 끝

07 Part 2 · 플러그인으로 포장

패키지 안에 무엇이 담기나

deploy-kit/ ├── .claude-plugin/plugin.json ← 이름표 ├── skills/deploy/ ← /deploy-kit:deploy ├── agents/reviewer.md ← 리뷰 에이전트 ├── hooks/hooks.json ← 커밋 전에 자동으로 검사 └── .mcp.json ← 외부 도구 연결

스킬, 에이전트, 훅, MCP 서버까지 패키지 하나에 담긴다

08 Part 2 · 플러그인으로 포장

팀 GitHub 저장소에 올려두면
배포 준비 완료

/plugin marketplace add 우리팀/plugins   # 처음 한 번만 등록
/plugin install deploy-kit              # 설치는 여기서 끝

팀원은 두 줄이면 설치가 끝난다

09 Part 3 · 자동 업데이트

내가 버전을 올리면
팀 전체가 바로 새 버전을 받는다

나

버전을 올려 푸시한다

"version": "1.1.0"

자동 전달

팀원

모두 새 버전으로 갱신

따로 받을 필요 없이 그대로 최신

슬랙으로 파일 다시 보낼 일이 사라진다

10 Part 3 · 자동 업데이트

프로젝트 scope로 설치하면

/plugin install deploy-kit --scope project

설정이 프로젝트 저장소에 들어간다

레포를 클론하면 그대로 적용

신규 입사자 온보딩에서 설정 복사가 사라진다

11 덤

덤으로 따라오는 것

01

이름 충돌 걱정 없음

기능 이름 앞에 플러그인 이름이 붙는다

/deploy-kit:deploy

02

끄고 켜기

필요 없으면 삭제 대신 잠시 꺼둔다

/plugin disable deploy-kit

WRAP UP

플러그인은 —

내 도구를 팀에 나눠주는
배포 채널

파일 복사와 달리, 고치면 팀 모두에게 바로 반영된다.

BOAZ · PEC · Product Engineering