Creator Hian의 Claude Code 플러그인 마켓플레이스
이 저장소는 Claude Code의 기능을 확장하기 위한 커스텀 플러그인을 개발하고 공유하는 공간입니다.
Claude Code는 강력한 AI 기반 개발 도구이지만, 사용자별/프로젝트별 특화 요구사항을 충족하기 위해서는 커스텀 확장이 필요합니다. 이 저장소는:
- ✅ 플러그인 템플릿 제공: 빠른 시작을 위한 표준 구조
- ✅ 자동화 스크립트: 신규 플러그인 생성 자동화 (
create_plugin.py) - ✅ 마켓플레이스 구조: 여러 플러그인을 체계적으로 관리
- ✅ 문서화: Skills, Agents, Commands, Hooks 개발 가이드
- 개발자: 자신의 워크플로우에 맞춘 Claude Code 확장 개발
- 팀: 팀 전체가 사용할 공통 플러그인 공유
- 커뮤니티: 유용한 플러그인을 오픈소스로 공유
현재 저장소에서 제공하는 플러그인 목록:
- 설명: C# 개발을 위한 현대적인 async/await 패턴, 코드 스타일, XML 문서화
- 버전: 1.4.0
- 위치:
./csharp-plugin - Agents: 1개 (csharp-pro)
- Skills: 3개
csharp-async-patterns- async/await, CancellationToken, ConfigureAwait 패턴csharp-code-style- C# 코딩 컨벤션 및 스타일 가이드csharp-xml-docs- XML 문서화 표준 (한/영 지원)
- 설명: Unity 게임 개발을 위한 종합 플러그인 (async, 성능, 아키텍처, UI, 네트워킹)
- 버전: 1.4.0
- 위치:
./unity-plugin - Agents: 2개 (unity-developer, unity-dots-developer)
- Skills: 13개
unity-async- 코루틴, async/await, Job System, 메인 스레드 제약unity-collection-pool- 컬렉션 풀링 및 메모리 관리unity-csharp-fundamentals- Unity C# 기초 패턴unity-unitask- UniTask 제로 할당 async (Cysharp)unity-r3- R3 모던 리액티브 프로그래밍 (Cysharp)unity-unirx- UniRx 레거시 리액티브 패턴unity-vcontainer- VContainer 의존성 주입unity-testrunner- Unity 테스트 자동화unity-textmeshpro- TextMeshPro 텍스트 렌더링unity-mobile- iOS/Android 최적화, IL2CPPunity-networking- Netcode, Mirror, Photon 멀티플레이어unity-performance- 프로파일링, 드로우콜, 배칭, LODunity-ui- UI Toolkit, UGUI, Canvas 최적화
- 설명: OpenAI Codex CLI 통합 및 Claude-Codex dual-AI 오케스트레이션 패턴
- 버전: 1.4.0
- 위치:
./codex-plugin - Agents: 없음 (Skills 기반)
- Skills: 2개
codex-cli- Codex CLI 명령어 (codex exec, 모델 선택, sandbox 모드)codex-claude-loop- 6-Phase dual-AI 협업 워크플로우 오케스트레이션
- 설명: Google Gemini CLI 통합 및 Claude-Gemini dual-AI 오케스트레이션 패턴
- 버전: 1.1.0
- 위치:
./gemini-plugin - Agents: 없음 (Skills 기반)
- Skills: 2개
gemini-cli- Gemini CLI 명령어 (모델 선택, 출력 포맷, 세션 관리)gemini-claude-loop- Claude-Gemini dual-AI 협업 워크플로우
- 설명: Multi-AI 오케스트레이션 (Claude + Codex + Gemini) 종합 검증 패턴
- 버전: 1.2.0
- 위치:
./ai-orchestration-plugin - Agents: 없음 (Skills 기반)
- Skills: 1개
ai-orchestration-feedback-loop- Triple-AI/Dual-AI 모드, 역할 분담 (Claude=계획/구현, Codex=검증/보안, Gemini=창의적 리뷰/UX)
- 설명: Git 워크플로우 자동화 - PR 강화 (/pr-enhance)
- 버전: 1.2.1
- 위치:
./git-plugin - Commands: 1개 (
/pr-enhance)
- 설명: 에이전트 팀 기반 병렬 디스패치 (다관점 계획 수립 + 적대적 리뷰)
- 버전: 1.0.0
- 위치:
./agent-team-plugin - Agents: 없음 (Skills 기반)
- Skills: 2개
diverse-plan- 다관점 Perspectives Team 기반 계획 수립da-review- Devil's Advocate Team 기반 적대적 리뷰
| Plugin | Version | Agents | Skills | 주요 도메인 |
|---|---|---|---|---|
| csharp-plugin | 1.4.0 | 1 | 3 | C# async, 코드 스타일, XML docs |
| unity-plugin | 1.4.0 | 2 | 13 | Unity 게임 개발 전반 |
| codex-plugin | 1.4.0 | 0 | 2 | Codex CLI, Claude-Codex 협업 |
| gemini-plugin | 1.1.0 | 0 | 2 | Gemini CLI, Claude-Gemini 협업 |
| ai-orchestration-plugin | 1.2.0 | 0 | 1 | Multi-AI (Triple/Dual) 오케스트레이션 |
| git-plugin | 1.2.1 | 0 | 0 | PR 강화 자동화 |
| agent-team-plugin | 1.0.0 | 0 | 2 | 에이전트 팀 기반 계획/리뷰 |
| 총계 | - | 3 | 23 | - |
| Plugin | Skill Name | 카테고리 | 설명 |
|---|---|---|---|
| csharp | csharp-async-patterns |
Programming | async/await, CancellationToken 패턴 |
| csharp | csharp-code-style |
Programming | C# 코딩 컨벤션 및 스타일 가이드 |
| csharp | csharp-xml-docs |
Documentation | XML 문서화 표준 |
| unity | unity-async |
Async | Unity 비동기 패턴 기초 |
| unity | unity-collection-pool |
Optimization | 컬렉션 풀링 및 메모리 관리 |
| unity | unity-csharp-fundamentals |
Programming | Unity C# 기초 패턴 |
| unity | unity-unitask |
Async | UniTask 제로 할당 async |
| unity | unity-r3 |
Reactive | R3 모던 리액티브 (Cysharp) |
| unity | unity-unirx |
Reactive | UniRx 레거시 리액티브 |
| unity | unity-vcontainer |
Architecture | VContainer DI |
| unity | unity-testrunner |
Testing | Unity 테스트 자동화 |
| unity | unity-textmeshpro |
UI | TextMeshPro 텍스트 렌더링 |
| unity | unity-mobile |
Platform | 모바일 최적화 |
| unity | unity-networking |
Multiplayer | 네트워크/멀티플레이어 |
| unity | unity-performance |
Optimization | 성능 최적화 |
| unity | unity-ui |
UI | UI Toolkit, UGUI |
| codex | codex-cli |
Integration | Codex CLI 기본 명령어 |
| codex | codex-claude-loop |
Orchestration | Claude-Codex Dual-AI 워크플로우 |
| gemini | gemini-cli |
Integration | Gemini CLI 기본 명령어 |
| gemini | gemini-claude-loop |
Orchestration | Claude-Gemini Dual-AI 워크플로우 |
| ai-orch | ai-orchestration-feedback-loop |
Orchestration | Triple/Dual AI 종합 검증 루프 |
| agent-team | diverse-plan |
Orchestration | 다관점 Perspectives Team 계획 수립 |
| agent-team | da-review |
Orchestration | Devil's Advocate Team 적대적 리뷰 |
claude-code-plugins/
├── .claude-plugin/ # 저장소 메타데이터
├── README.md # 이 문서
├── CHANGELOG.md # 변경 이력
│
├── docs/ # 프로젝트 문서
│ ├── architecture/ # 아키텍처 관련 문서
│ │ └── SKILL_SEPARATION_STRATEGY.md # C# ↔ Unity 분리 전략
│ └── evaluation/ # 평가 관련 문서
│ ├── SKILL_EVALUATION_GUIDE.md # SKILL 평가 가이드
│ └── status/ # 플러그인별 평가 상태
│ └── unity-plugin.md # Unity Plugin 평가 상태
│
├── tools/ # 개발 도구
│ ├── create_plugin.py # 신규 플러그인 생성 스크립트
│ ├── TEST_SCRIPT.md # 테스트 가이드
│ └── plugin-template/ # 플러그인 템플릿 (복사용)
│ ├── .claude-plugin/
│ │ └── plugin.json # 플러그인 메타데이터
│ ├── agents/ # Subagent 정의
│ ├── command/ # 커스텀 슬래시 명령어
│ ├── hook/ # 라이프사이클 훅
│ ├── skills/ # Skills 정의 (핵심!)
│ └── README.md # 템플릿 사용 가이드
│
├── csharp-plugin/ # C# 개발 플러그인
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── agents/
│ │ └── csharp-pro.md # C# 전문가 에이전트
│ ├── skills/
│ │ ├── csharp-async-patterns/ # async/await 스킬
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ ├── csharp-code-style/ # 코딩 컨벤션 스킬
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── csharp-xml-docs/ # XML 문서화 스킬
│ │ ├── SKILL.md
│ │ └── references/
│ └── README.md
│
├── unity-plugin/ # Unity 게임 개발 플러그인
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── agents/
│ │ ├── unity-developer.md # 메인 Unity 에이전트
│ │ ├── unity-dots-developer.md # DOTS 전문 에이전트
│ │ └── legacy/ # v1.0 레거시 에이전트
│ ├── skills/ # 13개 전문 스킬
│ │ ├── unity-async/
│ │ ├── unity-collection-pool/
│ │ ├── unity-csharp-fundamentals/
│ │ ├── unity-unitask/
│ │ ├── unity-r3/
│ │ ├── unity-unirx/
│ │ ├── unity-vcontainer/
│ │ ├── unity-testrunner/
│ │ ├── unity-textmeshpro/
│ │ ├── unity-mobile/
│ │ ├── unity-networking/
│ │ ├── unity-performance/
│ │ └── unity-ui/
│ └── README.md
│
├── codex-plugin/ # Codex CLI 통합 플러그인
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── skills/
│ │ ├── codex-cli/ # CLI 기본 스킬
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ │ ├── commands.md
│ │ │ ├── options.md
│ │ │ └── examples.md
│ │ └── codex-claude-loop/ # Claude-Codex Dual-AI 스킬
│ │ └── SKILL.md
│ └── README.md
│
├── gemini-plugin/ # Gemini CLI 통합 플러그인
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── skills/
│ │ ├── gemini-cli/ # CLI 기본 스킬
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ │ ├── commands.md
│ │ │ ├── options.md
│ │ │ └── examples.md
│ │ └── gemini-claude-loop/ # Claude-Gemini Dual-AI 스킬
│ │ └── SKILL.md
│ └── README.md
│
├── ai-orchestration-plugin/ # Multi-AI 오케스트레이션 플러그인
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── skills/
│ │ └── ai-orchestration-feedback-loop/ # Triple/Dual AI 통합 스킬
│ │ └── SKILL.md
│ └── README.md
│
├── agent-team-plugin/ # 에이전트 팀 기반 계획/리뷰 플러그인
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── skills/
│ │ ├── diverse-plan/ # 다관점 계획 수립 스킬
│ │ │ └── SKILL.md
│ │ └── da-review/ # 적대적 팀 리뷰 스킬
│ │ └── SKILL.md
│ └── README.md
│
└── git-plugin/ # Git 워크플로우 자동화 플러그인
├── .claude-plugin/
│ └── plugin.json
├── commands/
│ └── pr-enhance.md # /pr-enhance 명령어
└── README.md
tools/create_plugin.py 스크립트를 사용하면 대화형 CLI로 쉽게 플러그인을 생성할 수 있습니다.
python tools/create_plugin.py스크립트가 다음 정보를 요청합니다:
Plugin name (kebab-case, e.g., my-plugin): typescript-helper
Description: TypeScript development best practices and patterns
Author name: Your Name
Version [1.0.0]: (Enter로 기본값)
📋 Plugin Information Summary:
Name: typescript-helper
Description: TypeScript development best practices and patterns
Author: Your Name
Version: 1.0.0
Proceed with plugin creation? (y/n): y
✅ Plugin Created Successfully!
Plugin Name: typescript-helper
Location: ./typescript-helper
📖 Next Steps:
1. cd typescript-helper
2. Add your custom agents, commands, hooks, or skills
3. Update README.md with usage instructions
4. Test your plugin with Claude Code
Skills는 Claude Code에 **재사용 가능한 절차적 지식(procedural knowledge)**을 추가하는 모듈입니다.
| 측면 | Skills | Agents/Subagents |
|---|---|---|
| 목적 | 재사용 가능한 절차적 지식 | 프로젝트별 복잡한 워크플로우 |
| 범위 | 도메인 전문성 (언어, 프레임워크) | 작업 전문화 (구현, 테스트, 리뷰) |
| 활성화 | 맥락 기반 자동 | 명시적 호출 |
| 재사용성 | 여러 프로젝트에서 공유 | 프로젝트 특화 |
| 내용 | How-to, 베스트 프랙티스 | 프로젝트 맥락, 워크플로우 |
간단 정리:
- Skills: "어떻게 하는가" (how-to) 지식 → 여러 곳에서 재사용
- Agents/Subagents: "무엇을 하는가" (워크플로우) → 프로젝트에 특화
Skills는 필요한 시점에만 콘텐츠를 로드하여 context window를 효율적으로 사용합니다.
YAML frontmatter로 정의되며, Claude Code가 "어떤 Skills가 있는지" 인지합니다.
---
name: csharp-core
description: C# 기본 언어, 코딩 컨벤션, .NET 프레임워크 기초
category: programming
language: csharp
---특징:
- 시스템 프롬프트에 자동 포함
- Skill 발견(discovery)용 경량 등록
- ~100 tokens per skill
SKILL.md 파일의 본문 내용으로, Skill이 호출될 때만 로드됩니다.
# C# Core Skills
## 코딩 컨벤션
- Classes, Methods: PascalCase
- Parameters, Local variables: camelCase
- Private fields: _camelCase
## 언어 기능
- async/await 패턴 활용
- LINQ 쿼리 문법
- null 안전성 (nullable reference types)
더 자세한 내용은 [REFERENCE.md](resources/REFERENCE.md) 참조특징:
- 절차적 지식(procedural knowledge) 제공
- 워크플로우 및 베스트 프랙티스
- ~5,000 tokens 권장
resources/ 폴더에 위치한 추가 자료로, 명시적으로 참조될 때만 로드됩니다.
skills/
└── csharp-core/
├── SKILL.md # Level 1-2
└── resources/ # Level 3
├── REFERENCE.md # 상세 API 레퍼런스
├── PATTERNS.md # 디자인 패턴 모음
├── EXAMPLES.md # 대량 코드 스니펫
└── scripts/
├── analyze.ps1 # PowerShell (Windows)
└── analyze.sh # Bash (Unix/Linux/Mac)
특징:
- 로드되기 전까지 0 tokens 소비
- 크기 제한 없음
- 상세 레퍼런스, 스크립트, 템플릿 등
전통적 방식 (모든 내용 항상 로드)
Skills 10개 × 15,000 tokens = 150,000 tokens (항상 소비)
Progressive Disclosure 방식
Level 1 (항상): 10 skills × 100 tokens = 1,000 tokens
Level 2 (활성화시): 1 skill × 5,000 tokens = 5,000 tokens
Level 3 (참조시): 1 resource × 10,000 tokens = 10,000 tokens
────────────────────────────────────────────────────────
총 사용: 16,000 tokens (필요시에만)
절약: 134,000 tokens (89% 절감)
실전 예시: Unity C# 테스트 코드 작성
설치된 Skills: 10개 (각 15K tokens)
- Level 1 로드: 1,000 tokens (모든 Skills 메타데이터)
- Level 2 로드: 5,000 tokens (csharp-testing skill만 활성화)
- Level 3 로드: 3,000 tokens (테스트 패턴 예시만 참조)
────────────────────────────────────────────────────────
실제 사용: 9,000 tokens
전체 로드시: 150,000 tokens
절약: 141,000 tokens (94% 절감)
- ✅ 간결한 description (1-2문장, ~100 tokens)
- ✅ 명확한 Skill 용도 설명
- ❌ 절차, 예시, 상세 설명 포함 금지
Good:
description: C# 기본 언어, 코딩 컨벤션, .NET 프레임워크 기초Bad:
description: |
이 Skill은 C# 프로그래밍 언어의 모든 것을 다룹니다.
네이밍 컨벤션부터 시작해서 PascalCase, camelCase 규칙,
async/await 패턴, LINQ 쿼리...
(100 tokens 초과)- ✅ 핵심 워크플로우와 베스트 프랙티스
- ✅ Level 3 리소스로의 링크 제공
- ❌ 대용량 예시나 중복 설명 포함 금지
Good:
## async/await 패턴
1. I/O 작업에는 항상 async 메서드 사용
2. Task 반환 타입 선택
3. ConfigureAwait(false) 고려
자세한 예시는 [PATTERNS.md](resources/PATTERNS.md) 참조- ✅ 상세 레퍼런스, 대량 예시, 스크립트
- ✅ 논리적 카테고리별 파일 분리
- ✅ 크기 제한 없음 (사용 안 하면 0 tokens)
언어/프레임워크:
csharp-async-patterns- C# async/await 패턴csharp-xml-docs- C# XML 문서화 표준unity-async- Unity 비동기 프로그래밍 패턴unity-r3- R3 리액티브 패턴 (Cysharp)
개발 프랙티스:
unity-performance- Unity 성능 최적화unity-mobile- 모바일 플랫폼 최적화codex-claude-loop- Dual-AI 협업 오케스트레이션
각 Plugin은 다음 구성 요소를 포함할 수 있습니다:
플러그인 메타데이터 정의
{
"name": "your-plugin-name",
"description": "플러그인 설명",
"version": "1.0.0",
"author": {
"name": "작성자 이름"
}
}특정 작업을 수행하는 지능형 에이전트 정의
---
name: implementation-agent
description: C# 코드 구현 전담 Agent
skills: csharp-core, csharp-unity # Skills 활용
model: sonnet
---
# Implementation Agent
실제 C# 코드 작성 및 구현을 담당합니다.커스텀 슬래시 명령어 구현
/analyze-performance- 성능 분석 자동화/deploy-production- 프로덕션 배포 프로세스/generate-docs- 문서 자동 생성
라이프사이클 이벤트 훅 정의
pre-write- 파일 쓰기 전 실행post-write- 파일 쓰기 후 실행pre-commit- Git 커밋 전 실행
재사용 가능한 절차적 지식 모듈 (상세 내용은 위 섹션 참조)
# 1. 신규 Plugin 생성
python tools/create_plugin.py
# 2. Plugin 디렉토리로 이동
cd your-plugin-name
# 3. Skills, Agents 등 추가
# skills/ 폴더에 SKILL.md 작성
# agents/ 폴더에 agent.md 작성
# 4. README 작성
# 플러그인 사용법, 설치 방법 등 문서화
# 5. 테스트
# Claude Code에서 실제 사용해보기
# 6. Git 커밋
git add .
git commit -m "Add new plugin: your-plugin-name"- Plugin 이름: kebab-case (예:
typescript-helper) - Skill 이름:
domain-subdomain형식 (예:csharp-async-patterns,unity-r3) - Agent 이름:
role-function형식 (예:csharp-pro,unity-developer)
- ✅ Skills: 범용 how-to 지식
- ✅ Agents: 프로젝트 특화 워크플로우
- ✅ 명시적 선언: Agent에서 사용할 Skills 명시
각 구성 요소에 다음 포함:
- 목적: 무엇을 위한 것인가?
- 범위: 어디까지 담당하는가?
- 사용 예시: 언제 활성화되는가?
- 제외 사항: 무엇은 담당하지 않는가?
문제 발견 시:
- 버그 리포트
- 기능 제안
- 개선 아이디어
새로운 플러그인 추가:
- Fork 저장소
- 신규 플러그인 개발
- 테스트 및 문서화
- Pull Request 생성
유용한 플러그인 개발 시:
- 커뮤니티와 공유
- 사용법 명확히 문서화
- 예시 코드 제공
플러그인 배포 시 적절한 라이선스를 선택하고 명시하세요.
Happy Plugin Development! 🚀