테마 전환
MCP 서버가 "필요할 때 연결하는 통로"라면, 이 편에서 다루는 도구들은 한 번 설정하면 계속해서 작동하는 지식 인프라입니다. 플러그인은 빠른 실행을, 스킬은 깊은 지식을, Actions는 최신성 유지를 담당합니다.
Claude Code 플러그인 생태계
Repomix는 Claude Code 사용자를 위해 세 가지 공식 플러그인을 제공합니다. 설치는 매우 간단합니다.
text
# 1. 마켓플레이스에서 Repomix 제공자 추가
/plugin marketplace add yamadashy/repomix
# 2. 필요한 플러그인 설치
/plugin install repomix-mcp@repomix # MCP 기반 분석 (추천 기반)
/plugin install repomix-commands@repomix # 슬래시 명령 확장 (편의성)
/plugin install repomix-explorer@repomix # AI 기반 심층 탐색 (분석 강화)세 플러그인은 서로 보완 관계에 있습니다. repomix-mcp가 기초적인 연결을 담당하고, repomix-commands가 사용자에게 편리한 명령어를 제공하며, repomix-explorer가 그 위에서 고도화된 분석을 수행합니다. 세 가지를 모두 설치했을 때 가장 완전한 경험을 할 수 있습니다.
플러그인별 역할과 슬래시 명령
| 플러그인 | 핵심 역할 | 제공하는 가치 |
|---|---|---|
repomix-mcp | MCP 서버 연동 | 로컬/원격 저장소 묶기, 출력물 검색, 자동 Tree-sitter 압축 |
repomix-commands | 퀵 커맨드 제공 | /repomix-commands:pack-local 등 슬래시 명령으로 즉시 실행 |
repomix-explorer | AI 기반 분석 에이전트 | /repomix-explorer:explore-local 등으로 자연어 기반 코드 조사 |
특히 Explorer 플러그인은 npx repomix로 저장소를 묶은 뒤, Grep와 Read 도구로 필요한 조각만 효율적으로 검색하며 분석합니다. 덕분에 무분별하게 모든 코드를 컨텍스트에 넣지 않고도 정밀한 분석이 가능합니다.
실제 사용 예시:
text
/repomix-commands:pack-local
현재 프로젝트를 압축해서 마크다운으로 묶어줘
/repomix-explorer:explore-local ./src
인증 로직이 구현된 파일들을 찾아서 데이터 흐름을 분석해 줘에이전트 스킬: AI 전용 지식 팩 만들기
단일 파일로 합치는 것을 넘어, Repomix는 Claude Agent Skills 형식의 출력물을 생성할 수 있습니다. 이는 AI가 읽기 좋게 최적화된 여러 개의 참조 파일로 구성된 "지식 팩"을 만드는 것입니다.
bash
# 현재 디렉터리를 기반으로 스킬 생성
repomix --skill-generate
# 이름 지정하여 생성 (예: my-project-ref)
repomix --skill-generate my-project-reference
# 원격 저장소에서 바로 스킬 생성
repomix --remote https://github.com/user/repo --skill-generate생성된 스킬은 설치 위치에 따라 다르게 작동합니다.
- 개인 스킬 (
~/.claude/skills/): 내 컴퓨터의 모든 프로젝트 대화에서 해당 지식을 참조할 수 있습니다. - 프로젝트 스킬 (
.claude/skills/): 깃으로 공유하여 팀원 모두가 동일한 참조 지식을 갖게 합니다.
자동화나 CI를 위해 --skill-output <path>와 --force 옵션을 사용하여 확인 절차 없이 특정 경로에 스킬을 생성할 수도 있습니다.
스킬 구성: 생성되는 다섯 가지 파일
스킬을 생성하면 다음과 같은 구조의 디렉터리가 만들어집니다.
text
.claude/skills/<skill-name>/
├── SKILL.md # 스킬 정의서 (이름, 설명, 활용 팁)
└── references/
├── summary.md # 저장소 요약, 통계 및 사용 지침
├── project-structure.md # 줄 수가 포함된 상세 디렉터리 트리
├── files.md # 모든 파일 내용 (grep 최적화 포맷)
└── tech-stacks.md # 언어, 프레임워크, 의존성 자동 분석 결과특히 tech-stacks.md는 package.json, go.mod, Cargo.toml 등을 자동으로 분석하여 생성되므로, AI가 해당 프로젝트의 기술 스택을 즉시 이해하는 데 큰 도움을 줍니다.
문서 중심의 전문 스킬 구축
코드뿐만 아니라 특정 라이브러리의 공식 문서만 담은 스킬을 만들어 AI에게 "전문 문서"로 제공할 수 있습니다.
bash
# Vite 공식 문서만 골라 스킬로 만들기
repomix --remote https://github.com/vitejs/vite --include docs --skill-generate이렇게 만든 문서 전용 스킬을 설치하면, AI가 최신 공식 문서의 내용을 바탕으로 정확한 API 사용법을 안내하게 됩니다.
Repomix Explorer 스킬 활용
플러그인 설치가 어려운 환경이라면, 완성된 Repomix Explorer 스킬을 직접 설치해 사용할 수 있습니다.
bash
# Codex, Cursor, OpenClaw 등 Agent Skills 지원 도구에 설치
npx skills add yamadashy/repomix --skill repomix-explorer --agent codex이 스킬을 설치하면 /repomix-explorer:explore-local과 같은 명령어를 통해 AI가 직접 내 코드를 탐색하고 분석하는 능력을 갖게 됩니다.
GitHub Actions: 컨텍스트 자동화
매번 수동으로 묶는 대신, PR이 올라올 때마다 자동으로 최신 컨텍스트 파일을 생성해 아티팩트로 남길 수 있습니다.
yaml
- name: Pack repository with Repomix
uses: yamadashy/repomix/.github/actions/repomix@main
with:
directories: src tests
include: "**/*.ts,**/*.md"
output: repomix-output.xml
compress: true
- name: Upload Repomix output
uses: actions/upload-artifact@v7
with:
name: repomix-context
path: repomix-output.xml이렇게 하면 리뷰어가 PR을 확인할 때, 최신 상태로 묶인 repomix-output.xml을 다운로드해 AI에게 전달함으로써 훨씬 정확한 리뷰를 수행할 수 있습니다.
나에게 맞는 통합 방식 선택하기
| 필요 사항 | 추천 선택지 | 이유 |
|---|---|---|
| 대화 중 실시간 분석 | repomix-mcp 플러그인 | AI가 직접 필요할 때만 읽어오므로 가장 효율적 |
| 빠른 실행과 편리한 명령 | repomix-commands 플러그인 | 복잡한 옵션 없이 슬래시 명령으로 즉시 실행 |
| 심층적인 코드 조사 | repomix-explorer 플러그인 | AI 기반의 전문 탐색 에이전트 활용 가능 |
| 나만의 지식 베이스 구축 | --skill-generate (스킬 생성) | 특정 라이브러리나 프로젝트를 상시 참조 지식으로 고정 |
| 팀 단위의 컨텍스트 공유 | .claude/skills/ 커밋 | 모든 팀원이 동일한 참조 지식을 공유하여 일관성 유지 |
| CI/CD 자동화 | GitHub Actions 액션 | 최신 코드를 자동으로 묶어 아티팩트로 제공 |
이제 Repomix를 단순한 도구를 넘어 팀의 인프라로 구축하는 방법까지 모두 살펴보았습니다. 마지막 편에서는 이 모든 기능을 활용해 실제로 AI에게 어떻게 질문하고 최고의 결과를 얻어내는지, 실전 예제집을 살펴보겠습니다.