Claude Code 플러그인 & 스킬 완전 정리 — 내가 쓰는 세팅

Claude Code에 설치한 플러그인, 스킬, 서브에이전트를 카테고리별로 정리하고 실제 사용법을 공유한다.

Claude Code를 반년 넘게 쓰면서 플러그인 생태계가 꽤 성숙해졌다. 현재 내가 쓰고 있는 세팅을 카테고리별로 정리한다.

설치된 플러그인 전체 목록

모두 claude-plugins-official 마켓플레이스 기반이다.

플러그인용도
oh-my-claudecode (omc)멀티 에이전트 오케스트레이션
superpowers개발 워크플로우 스킬 모음
ralph-loop반복 검증 루프
context7라이브러리 최신 문서 조회
playwright브라우저 자동화 (MCP)
githubGitHub 이슈/PR/코드 검색
commit-commands스마트 커밋, PR 생성
code-reviewPR 코드 리뷰
frontend-design프론트엔드 UI 생성
Notion노션 연동 (검색, 태스크, DB 조회)
claude-code-setup프로젝트별 자동화 추천

1. oh-my-claudecode (omc) — 멀티 에이전트 엔진

GitHub 8,700+ stars. Claude Code를 단일 에이전트에서 팀 단위 멀티 에이전트 시스템으로 확장한다.

핵심 실행 모드

모드명령어동작
Autopilot/autopilot "작업"아이디어 → 완성 코드까지 완전 자율 실행
Ralph/ralph "작업"verify → fix 루프를 통과할 때까지 반복
Team/team N: "작업"plan → PRD → execute → verify → fix 파이프라인
Ultrawork/ultrawork "작업"최대 병렬 실행, 에러 일괄 수정
CCG/ccg "작업"Claude + Codex + Gemini 트리-모델 오케스트레이션

에이전트 카탈로그 (32개)

omc는 작업 성격에 따라 전문 에이전트를 자동 라우팅한다.

빌드/분석 계열:

  • explore — 코드베이스 탐색, 심볼 매핑
  • analyst — 요구사항 명확화, 수용 기준 도출
  • planner — 작업 순서 설계, 실행 계획
  • architect — 시스템 설계, 경계, 인터페이스
  • debugger — 근본 원인 분석, 회귀 격리
  • executor — 코드 구현, 리팩토링
  • deep-executor — 복잡한 자율 목표 지향 작업
  • verifier — 완료 증거 수집, 주장 검증

리뷰 계열:

  • quality-reviewer — 로직 결함, 유지보수성, 안티패턴
  • security-reviewer — 취약점, 신뢰 경계, 인증/인가
  • code-reviewer — 종합 리뷰, API 계약, 하위 호환성

도메인 전문가 계열:

  • test-engineer — 테스트 전략, 커버리지
  • build-fixer — 빌드/툴체인/타입 에러
  • designer — UX/UI 아키텍처
  • writer — 문서, 마이그레이션 노트
  • document-specialist — 외부 문서/레퍼런스 조회
  • git-master — git 작업, 커밋 히스토리
  • code-simplifier — 코드 단순화
  • critic — 계획/설계 비판적 검토

모델 라우팅

단순 조회는 Haiku, 일반 구현은 Sonnet, 아키텍처/깊은 분석은 Opus로 자동 분배된다. 토큰 비용 최적화가 목적.

유틸리티 스킬

스킬용도
/deep-interview소크라테스식 질문으로 요구사항 구체화
/analyze코드베이스 깊은 분석
/plan전략적 계획 수립
/ralplan합의 기반 반복 계획 (Planner + Architect + Critic)
/deepinit코드베이스 초기화 + AGENTS.md 생성
/hud에이전트 상태 HUD 설정
/trace에이전트 흐름 타임라인
/omc-doctor설치 문제 진단
/note컴팩션 방지용 메모 저장

2. superpowers — 개발 방법론 스킬

obra/superpowers-marketplace에서 제공. 개발 워크플로우의 각 단계를 구조화한 스킬 모음이다.

스킬 목록

설계 & 계획:

  • /brainstorming — 기능 구현 전 의도/요구사항/설계 탐색. 창작 작업 전 필수.
  • /writing-plans — 스펙 기반 멀티 스텝 구현 계획 작성
  • /executing-plans — 작성된 계획을 체크포인트 기반으로 실행

구현:

  • /test-driven-development — RED-GREEN-REFACTOR 사이클 강제
  • /subagent-driven-development — 독립 작업들을 현재 세션에서 병렬 실행
  • /dispatching-parallel-agents — 2개 이상 독립 작업 병렬 분배

검증 & 리뷰:

  • /systematic-debugging — 버그/실패/예상 외 동작의 근본 원인 추적
  • /verification-before-completion — 완료 주장 전 증거 수집 강제
  • /requesting-code-review — 작업 완료 후 리뷰 요청
  • /receiving-code-review — 리뷰 피드백 수신 시 기술적 검증 후 반영

Git & 브랜치:

  • /using-git-worktrees — 격리된 worktree에서 기능 개발
  • /finishing-a-development-branch — 구현 완료 후 merge/PR/cleanup 의사결정

메타:

  • /using-superpowers — 전체 스킬 시스템 안내
  • /writing-skills — 새 스킬 작성 가이드

3. 공식 플러그인들

commit-commands — Git 자동화

명령어동작
/commit변경 사항 분석 → 커밋 메시지 자동 생성 → 커밋
/commit-push-pr커밋 → 푸시 → PR 생성까지 한번에
/clean_gone리모트에서 삭제된 로컬 브랜치 일괄 정리

Notion — 노션 연동

명령어동작
/notion:find "키워드"페이지/DB 검색
/notion:create-task "내용"태스크 생성
/notion:database-query "DB명"DB 조회
/notion:create-page새 페이지 생성

기타

  • context7 — /context7로 라이브러리 최신 문서를 조회해서 할루시네이션 방지
  • playwright — 브라우저 자동화. 스크린샷, 폼 입력, 네비게이션 등
  • github — 이슈/PR 생성, 코드 검색, 리뷰 등 GitHub API 직접 호출
  • code-review — PR 단위 코드 리뷰
  • frontend-design — /frontend-design으로 프로덕션급 프론트엔드 UI 생성
  • claude-code-setup — /claude-automation-recommender로 프로젝트에 맞는 자동화 추천

4. 커스텀 스킬 (직접 만든 것들)

플러그인과 별개로 CLAUDE.md에 직접 등록한 스킬들이다.

스킬용도
crig-concept-learning개념의 구조를 잡고(rigging) 핵심 문장으로 결정화(crystallizing)
debatePM1(확산) + PM2(비판) 3라운드 토론 후 PO 최종 결정
devil악마의 변호인 — 아이디어의 약점을 정면으로 짚기
debug구조화된 디버깅 프로세스
explain코드/아키텍처/기술 개념 설명
perf성능 분석 및 최적화
risk기술적/사업적 리스크 사전 평가
tech-decisionA vs B 기술 의사결정 분석
verify기술 주장/가정 팩트체크
test테스트 코드 작성 및 전략 설계
code-quality코드 품질 자동 점검

5. 서브에이전트 구성

CLAUDE.md에서 정의한 전문 서브에이전트들이다. Agent 도구로 호출된다.

에이전트역할
Explore코드베이스 탐색 (quick/medium/very thorough)
Plan구현 전략 설계, 아키텍처 트레이드오프
test-runner테스트 실행 및 실패 분석
security-auditor보안 취약점 탐지
researcher라이브러리/프레임워크/API 조사
refactorer코드 구조 개선, 중복 제거
performance-analyzer성능 병목 분석
devils-advocate기술 의사결정 반대 논거 제시
debugger에러/스택 트레이스 분석
code-reviewer코드 품질 리뷰
architect시스템 설계, 프로젝트 구조
claude-code-guideClaude Code 사용법 안내

CLAUDE.md 핵심 원칙

이 모든 도구 위에 깔린 행동 원칙은 Karpathy의 LLM 코딩 가이드라인 4가지다.

  1. Think Before Coding — 불확실하면 질문, 묵시적 가정 금지
  2. Simplicity First — 요청 범위 초과 금지, 과도한 추상화 금지
  3. Surgical Changes — 무관한 코드 건들지 마
  4. Goal-Driven Execution — 검증 가능한 목표로 변환, 증명 없이 완료 선언 금지

설치 방법

# 마켓플레이스 등록
/plugin marketplace add obra/superpowers-marketplace
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# 플러그인 설치
/plugin install superpowers@superpowers-marketplace
/plugin install oh-my-claudecode

# omc 초기 설정
/omc-setup

공식 플러그인(context7, github, commit-commands 등)은 Claude Code 설정에서 바로 활성화할 수 있다.

소감

플러그인을 많이 깔았다고 좋은 게 아니다. 핵심은 자기 워크플로우에 맞는 조합을 찾는 것이다.

내 경우 가장 자주 쓰는 조합:

  • 기획 단계: /deep-interview → /brainstorming → /writing-plans
  • 구현: /autopilot 또는 /team N:
  • 검증: /verification-before-completion → /requesting-code-review
  • 배포: /commit-push-pr

도구가 많아지면 오히려 어떤 걸 써야 할지 모르게 된다. 자주 쓰는 3-5개를 먼저 체화하고, 나머지는 필요할 때 꺼내 쓰는 게 맞다.

← All posts