Claude Code 플러그인 마켓플레이스
TUI 없이
/plugin install 한 번으로 preset 전체를 설치하는 두 번째 채널.플러그인 마켓플레이스란
Claude Code에는 플러그인 시스템이 있습니다. agent-harness-store는 각 preset을 Claude Code 플러그인 형태로 빌드해서 마켓플레이스에 등록합니다. 사용자는 /plugin 명령으로 한 번에 설치합니다.
현재 등록된 플러그인 (4개)
fe-agent-harness
Next.js/TypeScript 프로젝트를 위한 완전한 FE 하네스. 24개 rules + 26개 skills.
be-agent-harness
Flask/Python 프로젝트를 위한 완전한 BE 하네스. 21개 rules + 19개 skills.
nx-best-practices
Nx 모노레포 독립 preset. FE 하네스에 포함된 것과 동일하지만 단독으로도 설치 가능.
example-baseline
기여 시 참조용 최소 예시 preset.
마켓플레이스 사용 방법
# 1. 마켓플레이스 추가 (최초 1회)
/plugin marketplace add <마켓플레이스 URL 또는 로컬 경로>
# 2. 설치 가능한 플러그인 목록 확인
/plugin list
# 3. 플러그인 설치
/plugin install fe-agent-harness
/plugin install be-agent-harness
# 4. 설치 확인
/plugin list --installed
ℹ️ 마켓플레이스 URL은 팀 내 Bitbucket 또는 공유 서버에서 제공합니다. 설치 후에는 TUI 설치와 동일하게
.agents/ 폴더와 CLAUDE.md managed block이 생성됩니다.build-marketplace 빌드 프로세스
store 관리자가 콘텐츠를 업데이트하면 agent-harness-build-marketplace로 마켓플레이스를 재빌드합니다. 빌드 프로세스가 rules와 skills를 처리하는 방식이 다릅니다.
agent-harness-build-marketplace
├── presets/fe-agent-harness.yaml를 읽음
│ ├── rules 처리
│ │ ├── rules/workflow/plan-first.md → 변환
│ │ │ └── disable-model-invocation: true 추가
│ │ │ └── plugins/fe-agent-harness/skills/workflow-plan-first/SKILL.md
│ │ └── (24개 rules 모두 같은 방식으로 변환)
│ │
│ └── skills 처리
│ ├── skills/monorepo/nx-best-practices/ → 복사
│ │ └── name: "monorepo-nx-best-practices" (네임스페이싱)
│ │ └── plugins/fe-agent-harness/skills/monorepo-nx-best-practices/SKILL.md
│ └── (26개 skills 모두 같은 방식으로 복사)
│
└── .claude-plugin/marketplace.json 업데이트
Rule → Skill 변환
Marketplace에서는 rule도 Claude Code가 인식하는 skill 형태로 변환됩니다. 하지만 rule은 절차가 아닌 제약이므로 disable-model-invocation: true를 추가해 Claude가 참조만 하고 절차로 실행하지 않게 합니다.
Rule (원본)
---
name: Plan before code
description: Write and self-review...
tags: [workflow]
---
# Plan before code
Before writing code, write a
short implementation plan...
→
Skill (변환 후 — marketplace)
---
name: workflow-plan-first
description: Write and self-review...
disable-model-invocation: true
---
# Plan before code
Before writing code, write a
short implementation plan...
Skill 네임스페이싱
마켓플레이스에서는 skill id가 <category>-<id> 형식으로 네임스페이싱됩니다. 여러 preset에서 같은 skill을 포함해도 충돌하지 않도록 하기 위함입니다.
| 원본 경로 | 마켓플레이스 skill 이름 |
|---|---|
skills/monorepo/nx-best-practices/ | monorepo-nx-best-practices |
skills/auth/azure-ad-sso-flask/ | auth-azure-ad-sso-flask |
skills/code-review/are-we-done/ | code-review-are-we-done |
rules/workflow/plan-first (변환) | workflow-plan-first |
marketplace.json 구조
// .claude-plugin/marketplace.json
{
"version": "1.0",
"plugins": [
{
"id": "fe-agent-harness",
"name": "FE Agent Harness",
"description": "Complete rule and skill set for GS Retail frontend projects.",
"version": "1.0.0",
"path": "plugins/fe-agent-harness",
"skills": [
"workflow-plan-first",
"workflow-fe-tdd",
"monorepo-nx-best-practices",
"auth-azure-ad-sso-nextjs",
"code-review-are-we-done",
// ...
]
},
// be-agent-harness, nx-best-practices, example-baseline
]
}
마켓플레이스 vs TUI — 선택 기준
| 상황 | 선택 | 이유 |
|---|---|---|
| 새 프로젝트 부트스트랩 (팀 전체) | 마켓플레이스 | /plugin install 한 줄, CI/CD에 넣기 쉬움 |
| 특정 rule/skill만 추가 | TUI | 개별 항목 선택 가능 |
| 오프라인 환경 | TUI | 마켓플레이스는 서버 접근 필요 |
| 새 콘텐츠 테스트 | TUI | 마켓플레이스 빌드 없이 바로 설치 가능 |
| onboarding 자동화 | 마켓플레이스 | 스크립트로 설치 가능, Python 불필요 |
✅ 권장: 팀 onboarding 스크립트에 마켓플레이스 설치를 포함하세요. 새 개발자가 프로젝트를 클론하면
/plugin install fe-agent-harness 한 번으로 전체 AI 환경이 구성됩니다.