Phase 1313-6

마켓플레이스로 내 스킬·플러그인·에이전트 관리하기 (clone·pull·push)

Claude Code 플러그인 마켓플레이스의 구조를 이해하고, /plugin marketplace add 명령으로 스킬·플러그인·에이전트를 설치·관리합니다. git clone·pull·push의 세 가지 흐름으로 내 스킬을 버전관리·백업하고 여러 기기에 동기화하는 방법을 배웁니다. 한동노무법인 handong-cowork-plugins 레포를 '나만의 마켓플레이스'로 운영하는 실사례를 통해 실무 감각을 익힙니다.

마켓플레이스·플러그인·스킬·에이전트, 한 번에 정리

Claude Code 생태계에서 자주 나오는 네 단어를 노무사 언어로 정리하겠습니다. 마켓플레이스는 플러그인 카탈로그입니다. 사실상 git 레포(저장소)입니다. Claude Code의 /plugin → Discover 탭에 뜨는 목록이 마켓플레이스에서 옵니다. 공식 디렉토리(anthropics/claude-plugins-official)와 커뮤니티 마켓플레이스 수백 개가 있습니다. 플러그인은 스킬(Skill) + 선택적으로 에이전트(Agent)·슬래시 커맨드·MCP 서버를 하나로 묶은 패키지입니다. "터미널에서 /plugin 명령으로 한 번에 설치·관리하는 묶음"이라고 생각하면 됩니다. 스킬은 /슬래시커맨드 하나로 실행되는 자동화 프롬프트·파이프라인입니다. Phase 5에서 배운 그것입니다. handong-core-skills 안의 employment-rules-expert, park-sillo-judgment 같은 것들이 스킬입니다. 에이전트는 특정 역할을 맡아 자율적으로 판단하며 일하는 AI입니다. 스킬이 "레시피"라면, 에이전트는 "셰프"에 가깝습니다. OMC Team Mode의 exec 에이전트처럼 작업을 분담해서 처리합니다. 이 네 가지의 관계를 정리하면: 마켓플레이스 ⊃ 플러그인 ⊃ 스킬 + 에이전트(선택)
TIP: 마켓플레이스가 git 레포라는 사실이 핵심입니다. git을 이해하면 마켓플레이스 전체가 보입니다. 이어지는 섹션에서 git 세 가지 개념을 쉽게 설명합니다.

/plugin marketplace add 로 설치·관리하기

마켓플레이스에서 플러그인을 추가하는 명령은 하나입니다. /plugin marketplace add [주소] 주소 형식은 네 가지를 지원합니다. - GitHub 레포: owner/repo 형식 - Git URL: https://github.com/owner/repo.git - 로컬 경로: /Users/노무사/내플러그인폴더 - 원격 URL: 커뮤니티 마켓플레이스 URL 추가하면 Claude Code의 Discover 탭에 해당 플러그인이 나타납니다. 설치·제거·업데이트는 /plugin 인터랙티브 인터페이스 또는 CLI에서 모두 처리할 수 있습니다. Claude Code는 시작할 때 마켓플레이스와 설치된 플러그인을 자동 갱신(auto-update)할 수 있습니다. 새 스킬을 레포에 올려두면 다음 실행 때 자동으로 반영됩니다. 자주 쓰는 플러그인 예시: - commit-commands: git commit·push·PR 생성 워크플로우 - pr-review-toolkit: PR 리뷰 에이전트 - handong-core-skills: 한동노무법인 전용 스킬 패키지
# 마켓플레이스에 레포 추가 (GitHub 형식)
  /plugin marketplace add anthropics/claude-plugins-official
  
  # 커뮤니티 레포 추가 (OMC)
  /plugin marketplace add Yeachan-Heo/oh-my-claudecode
  
  # 내 레포 추가 (한동노무법인 전용)
  /plugin marketplace add silobust-hash/handong-cowork-plugins
  
  # 로컬 경로로 추가 (개발 중인 플러그인 테스트)
  /plugin marketplace add /Users/silronomusa/dev/my-plugin
  
  # 추가 후 설치
  /plugin
  # → Discover 탭에서 플러그인 선택 → Install
  
  # 설치된 플러그인 목록 확인
  /plugin list
  
  # 특정 플러그인 업데이트
  /plugin update handong-core-skills
  
  # 제거
  /plugin remove commit-commands
TIP: 내 레포를 마켓플레이스에 추가하려면 레포 안에 .claude-plugin/marketplace.json 파일이 있어야 합니다. 이 파일이 플러그인 이름·설명·스킬 목록을 정의합니다. 다음 섹션에서 실제 구조를 확인합니다.

git 3대 개념: clone·pull·push — 노무사 언어로

마켓플레이스는 git 레포입니다. git을 모르면 마켓플레이스를 절반밖에 활용하지 못합니다. 세 가지 핵심 개념만 알면 됩니다. clone — 처음 통째로 받기 사무실에 새 직원이 입사했을 때, 회사 전체 서류함을 복사해서 책상에 가져다 놓는 것입니다. 레포를 처음 내 컴퓨터에 가져올 때 씁니다. 한 번만 합니다. pull — 원격 변경분 당겨오기 사무실 공용 서류함에 동료가 새 서류를 추가했을 때, 내 책상 복사본을 최신으로 업데이트하는 것입니다. 레포에 새 스킬이 추가되면 pull로 가져옵니다. push — 내 변경분 올리기 내 책상에서 수정한 서류를 공용 서류함에 업로드하는 것입니다. 내가 스킬을 수정하거나 추가한 뒤 레포에 반영할 때 씁니다. 이 세 가지가 마켓플레이스에서 스킬·플러그인·에이전트의 버전관리·백업·공유가 전부 git 흐름으로 이루어진다는 의미입니다. [노무사 실무에 대입] - clone: 사무실 PC에서 처음 handong-cowork-plugins 레포를 내려받기 - pull: 집 PC에서 사무실에서 추가한 새 스킬을 당겨오기 - push: 새로 만든 취업규칙 스킬을 레포에 올려서 사무실·집 PC 모두에서 쓸 수 있게 하기
# git 3대 명령 실전 예시
  
  # [clone] 한동 코워크 플러그인 레포를 내 PC에 처음 받기
  git clone https://github.com/silobust-hash/handong-cowork-plugins
  cd handong-cowork-plugins
  
  # [pull] 레포에 새 스킬이 올라왔을 때 집 PC에서 최신화
  git pull origin main
  
  # [push] 새 스킬 파일을 만든 뒤 레포에 올리기
  # 1. 변경사항 확인
  git status
  
  # 2. 올릴 파일 선택 (새 스킬 파일만)
  git add skills/employment-rules-2026.md
  
  # 3. 커밋 메시지와 함께 저장
  git commit -m "취업규칙 2026 개정 반영 스킬 추가"
  
  # 4. 레포에 올리기
  git push origin main
  
  # → 이제 사무실 PC, 집 PC, 노트북 어디서든
  #   git pull 한 번으로 최신 스킬을 받아서 쓸 수 있습니다.

나만의 마켓플레이스: handong-cowork-plugins 실사례

박실로 노무사는 현재 github.com/silobust-hash/handong-cowork-plugins 레포를 "한동노무법인 코워크 플러그인·스킬 전체 백업"으로 운영하고 있습니다. 이것이 바로 "내 마켓플레이스" 실사례입니다. 이 레포에는 취업규칙 검토 스킬, 산재 사건 분석 에이전트, 직장내 괴롭힘 8단계 파이프라인, 병원 노무 전용 워크플로우 등 한동노무법인 전용 스킬·플러그인이 모여 있습니다. 운영 방식은 이렇습니다. [스킬 추가] 새 스킬을 만들면 skills/ 폴더에 마크다운 파일로 저장하고, git push로 레포에 올립니다. marketplace.json에 목록을 업데이트합니다. [여러 기기 동기화] 사무실 맥미니, 집 맥북, 노트북 세 곳에서 모두 같은 레포를 clone해두었습니다. 사무실에서 스킬을 수정하고 push하면, 집에서 git pull 한 번으로 최신 스킬을 받습니다. [백업] GitHub 레포가 곧 백업입니다. 컴퓨터가 고장나도 레포에서 git clone 한 번으로 모든 스킬을 복구합니다. [동료 공유] 팀원이 생기면 /plugin marketplace add silobust-hash/handong-cowork-plugins 한 줄로 팀 전체가 같은 스킬을 씁니다. 스킬을 개선하면 push → 팀원이 pull → 자동 전파. 이 구조는 노무법인 규모가 커질수록 더 강력해집니다. 스킬을 한 곳에서 관리하면 사무소 전체의 품질을 일관되게 유지할 수 있습니다.
# handong-cowork-plugins 레포 구조 예시
  
  # .claude-plugin/
  #   marketplace.json   ← 플러그인 카탈로그 정의 파일
  #
  # skills/
  #   employment-rules-expert.md   ← 취업규칙 검토 스킬
  #   park-sillo-judgment.md       ← 법적 판단 스킬
  #   handong-safety-router.md     ← 산업안전 라우터 스킬
  #   employment-rules-2026.md     ← 2026 개정 반영 스킬 (신규)
  #
  # agents/
  #   labor-case-agent.md          ← 노동사건 분석 에이전트
  #   safety-inspector-agent.md    ← 산업안전 점검 에이전트
  #
  # CLAUDE.md                      ← 플러그인 사용 지침
  
  # marketplace.json 예시 구조
  # {
  #   "name": "handong-cowork-plugins",
  #   "description": "한동노무법인 전용 스킬·에이전트 패키지",
  #   "version": "2.1.0",
  #   "skills": [
  #     "skills/employment-rules-expert.md",
  #     "skills/park-sillo-judgment.md",
  #     "skills/handong-safety-router.md"
  #   ],
  #   "agents": [
  #     "agents/labor-case-agent.md"
  #   ]
  # }
  
  # 다른 기기에서 설치하는 방법 (1줄)
  /plugin marketplace add silobust-hash/handong-cowork-plugins

commit-commands 플러그인과 실전 워크플로우

commit-commands는 git commit·push·PR 생성 워크플로우를 자동화하는 플러그인입니다. 스킬 파일을 수정하고 레포에 올리는 반복 작업을 /commit 한 번으로 처리합니다. 노무사 입장에서 이 플러그인이 유용한 이유는 하나입니다. git commit 메시지 작성이나 PR 설명 작성에 AI가 개입해서, "어떤 스킬을 왜 수정했는지"를 자동으로 기록해줍니다. 3개월 뒤 "이 스킬 왜 이렇게 바꿨지?"를 확인할 때 그 기록이 남아 있습니다. [실전 워크플로우: 스킬 추가 후 레포 반영] 1단계: 새 스킬 파일 작성 skills/hospital-night-shift-2026.md (요양병원 야간근무 스킬) 2단계: commit-commands 플러그인으로 커밋 /commit → AI가 변경 내용을 분석해서 커밋 메시지 초안 제안 → 확인 후 push까지 자동 처리 3단계: 다른 기기에서 자동 갱신 확인 (Claude Code 재시작 시 auto-update로 자동 반영) 또는 수동으로: git pull origin main [pr-review-toolkit 플러그인] 팀원과 함께 스킬을 개발할 때 유용합니다. 새 스킬 파일을 PR(Pull Request)로 올리면, pr-review-toolkit이 내용을 검토해서 개선 제안을 달아줍니다. 노무사가 만든 스킬의 법적 정확성 체크리스트를 PR 리뷰 단계에 삽입해두면, 팀 전체의 스킬 품질을 일관되게 유지할 수 있습니다.
# commit-commands 플러그인 설치 및 활용
  
  # 1. 설치
  /plugin marketplace add anthropics/claude-plugins-official
  /plugin install commit-commands
  
  # 2. 스킬 파일 수정 후 커밋
  # (예: 요양병원 야간근무 스킬 신규 작성 완료 후)
  /commit
  
  # → AI가 변경 내용 분석 후 커밋 메시지 제안:
  # "feat(skills): 요양병원 야간근무 연장수당 산정 스킬 추가
  #  - 근로기준법 제56조 기준 야간·연장·휴일 중복 적용 로직
  #  - 의료법 인력 기준 교차 검토 포함"
  
  # 확인 후 push까지 자동 처리
  
  # 3. pr-review-toolkit으로 팀 스킬 검수 (팀 운영 시)
  /plugin install pr-review-toolkit
  # → 새 스킬 PR 올리면 AI가 내용 검토 + 개선 제안 자동 등록
  
  # 4. 집 PC에서 최신 스킬 받기
  git pull origin main
  # Claude Code 재시작 → 새 스킬 자동 적용
TIP: 스킬 파일을 수정할 때마다 git commit을 습관화하면, 언제 어떤 이유로 스킬이 바뀌었는지 이력이 남습니다. 1년 뒤 비슷한 사건이 들어왔을 때, 그 시점의 스킬로 돌아가서 비교할 수도 있습니다. git이 단순한 백업이 아니라 시간여행 도구가 되는 이유입니다.

마켓플레이스 운영 실전 체크리스트

지금까지 배운 내용을 바탕으로, 한동노무법인 마켓플레이스를 안정적으로 운영하기 위한 체크리스트를 정리합니다. [초기 설정 — 처음 한 번] - GitHub에 handong-cowork-plugins 레포 생성 (비공개 권장) - .claude-plugin/marketplace.json 파일 작성 (플러그인 카탈로그 정의) - 기존 스킬 파일들을 skills/ 폴더로 이동 후 git add·commit·push - 사무실 PC·집 PC·노트북 각각에서 git clone [신규 스킬 추가 루틴] 1. 스킬 마크다운 파일 작성 2. marketplace.json 업데이트 3. /commit (commit-commands) 또는 직접 git add·commit·push 4. 다른 기기에서 git pull (또는 Claude Code 재시작 시 auto-update) [주의사항] - GitHub 레포가 공개(public)이면 스킬 내용이 외부에 노출됩니다. 의뢰인 정보·전략이 담긴 스킬은 비공개 레포로 관리하세요. - marketplace.json 형식을 지키지 않으면 /plugin이 플러그인을 인식하지 못합니다. 파일 추가·수정 시 JSON 문법을 확인하세요. - 한 번 push한 커밋은 팀원 기기에 pull되므로, 실수로 개인정보가 포함된 파일을 올리지 않도록 git status로 확인 후 push합니다. [확장 — 팀원과 함께] - 팀원에게 레포 Collaborator 권한 부여 - 팀원 PC에서 /plugin marketplace add silobust-hash/handong-cowork-plugins - 이후 스킬 업데이트는 push → pull로 전파됩니다.
# 마켓플레이스 일상 운영 명령어 모음
  
  # 현재 상태 확인 (변경된 파일 목록)
  git status
  
  # 특정 파일만 선택해서 올리기 (민감정보 실수 방지)
  git add skills/새스킬.md
  git add .claude-plugin/marketplace.json
  git commit -m "새스킬 추가"
  git push origin main
  
  # 최신 상태로 당겨오기 (집 PC에서 아침에 한 번)
  git pull origin main
  
  # 설치된 플러그인 전체 업데이트
  /plugin update --all
  
  # 특정 스킬만 재설치 (충돌 해결)
  /plugin remove handong-core-skills
  /plugin install handong-core-skills
  
  # 버전 이력 확인 (언제 무엇이 바뀌었는지)
  git log --oneline -20
  # → 최근 20개 커밋 내역 한 줄씩 표시
  
  # 특정 시점 스킬 내용 확인 (시간여행)
  git show abc1234:skills/employment-rules-expert.md
  # abc1234는 git log에서 확인한 커밋 해시

핵심 정리

  • 마켓플레이스는 git 레포 기반 플러그인 카탈로그입니다. /plugin marketplace add owner/repo 한 줄로 GitHub·Git URL·로컬 경로 어디서든 추가할 수 있습니다.
  • git 3대 개념인 clone(처음 통째로 받기)·pull(변경분 당겨오기)·push(내 변경 올리기)가 스킬·플러그인·에이전트의 버전관리·백업·동기화를 모두 책임집니다.
  • handong-cowork-plugins 레포처럼 '내 마켓플레이스'를 GitHub에 두면, 사무실·집·노트북 세 곳의 스킬을 push→pull 하나로 동기화하고 팀원과도 즉시 공유할 수 있습니다.
  • commit-commands 플러그인으로 스킬 수정 이력을 자동 기록해두면, 언제 어떤 이유로 스킬이 바뀌었는지 추적할 수 있어 품질 관리가 가능합니다.

이 강의가 어떠셨나요?