Agent Skills Repository

# Agent Skills Repository

Claude Code와 Codex CLI 기능을 확장하는 커스텀 스킬 모음입니다.

## Quick Install (원격 설치)

```bash
# 권장: Core 스킬 + CLI 도구 (한 줄 설치)
curl -fsSL https://raw.githubusercontent.com/<GITHUB_USERNAME>/agent-skills/main/setup.sh | bash -s -- --core --cli

# 전체 스킬 설치
curl -fsSL https://raw.githubusercontent.com/<GITHUB_USERNAME>/agent-skills/main/setup.sh | bash -s -- --all --cli --static

# 특정 버전 설치
curl -fsSL https://raw.githubusercontent.com/<GITHUB_USERNAME>/agent-skills/main/setup.sh | bash -s -- --version v2026.01.15

# 제거
curl -fsSL https://raw.githubusercontent.com/<GITHUB_USERNAME>/agent-skills/main/setup.sh | bash -s -- --uninstall
```

## Manual Install (수동 설치)

```bash
# 레포지토리 클론
git clone https://github.com/<GITHUB_USERNAME>/agent-skills.git ~/.agent-skills
cd ~/.agent-skills

# 권장: Core 스킬 + CLI 도구 설치
./install.sh --core --cli --link-static

# 또는 전체 설치 (모든 스킬)
./install.sh all --link-static --codex --cli

# 스킬 목록 확인
./install.sh --list
```

### 워크스페이스별 스킬 설치

```bash
# 프로젝트에서 필요한 스킬만 로컬 설치
cd my-project
agent-skill init                          # .claude/skills/ 생성
agent-skill install kubernetes-skill      # 로컬에 설치
agent-skill install ml/                   # 그룹 전체 설치

# Claude 실행 - 로컬 스킬 자동 로드
claude
```

## Installation Options

### 기본 설치

```bash
# 모든 스킬 설치 (심볼릭 링크)
./install.sh

# 그룹별 설치
./install.sh agents             # AI 에이전트
./install.sh development        # 개발 도구
./install.sh business           # 비즈니스
./install.sh integrations       # 외부 서비스 연동
./install.sh ml                 # ML/AI 도구

# 특정 스킬만 설치
./install.sh agents/planning-agents
```

### 추가 옵션

| 옵션 | 설명 |
|------|------|
| `--core` | Core 스킬만 전역 설치 (권장) |
| `--link-static` | `~/.agents` → `static/` 심링크 (글로벌 컨텍스트) |
| `--codex` | Codex CLI 지원 (AGENTS.md + skills 심링크) |
| `--cli` | `claude-skill` + `agent-skill` CLI 도구 설치 |
| `--copy` | 심링크 대신 복사 |
| `--dry-run` | 미리보기만 |
| `--prefix NAME` | 스킬 이름 접두사 |
| `--postfix NAME` | 스킬 이름 접미사 |

### Core 스킬 (워크스페이스 공통)

```bash
./install.sh --core
```

**Core 스킬 목록:**
- `meta/skill-manager` - 스킬 생태계 관리
- `meta/skill-recommender` - 스킬 자동 추천
- `development/git-commit-pr` - Git 커밋/PR 가이드
- `context/context-manager` - 프로젝트 컨텍스트 로드
- `context/whoami` - 사용자 프로필 관리

### 한 번에 전체 설치

```bash
./install.sh all --link-static --codex --cli
```

**실행 순서:**
1. `--link-static` → `~/.agents` 심링크
2. `--codex` → Codex CLI 지원 설정
3. `--cli` → CLI 도구 설치
4. `all` → 모든 스킬 설치

### 제거

```bash
./install.sh --uninstall              # 모든 스킬 제거
./install.sh --uninstall agents       # 특정 그룹 제거
./install.sh --unlink-static          # static 심링크 제거
./install.sh --uninstall-cli          # CLI 도구 제거
```

---

## Codex CLI 지원

Codex CLI에서도 동일한 스킬을 사용할 수 있습니다.

```bash
./install.sh --codex
```

**동작:**
1. `~/.codex/AGENTS.md`에 스킬 가이드 추가 (기존 내용 유지)
2. `~/.codex/skills` → `~/.claude/skills` 심링크 생성

**주의사항:**
- 기존 AGENTS.md 내용은 유지됩니다
- 이미 스킬 가이드가 있으면 덮어쓰지 않고 경고 출력
- 덮어쓰려면 수동으로 기존 스킬 섹션 제거 후 재설치

---

## CLI 도구

### agent-skill (스킬 관리)

워크스페이스별 동적 스킬 관리 도구입니다.

```bash
# 설치
./install.sh --cli

# 사용법
agent-skill install kubernetes-skill      # 로컬 설치
agent-skill install -g git-commit-pr      # 전역 설치
agent-skill install ml/                   # 그룹 전체 설치
agent-skill list                          # 스킬 목록
agent-skill list --installed --local      # 로컬 설치 확인
agent-skill uninstall kubernetes-skill    # 제거
agent-skill init                          # 워크스페이스 초기화
```

**스킬 로드 우선순위:**
1. `.claude/skills/` (현재 워크스페이스)
2. `~/.claude/skills/` (전역)

### claude-skill (스킬 실행)

CLI에서 스킬을 직접 실행하는 도구입니다.

```bash
# 별칭 추가 (선택)
./install.sh --cli --alias=cs

# 사용법
cs "보안 검사해줘"                # Claude가 스킬 자동 선택
cs --skill security-auditor "검사"  # 스킬 직접 지정
cs --list                         # 스킬 목록
cs --list --all --verbose         # 모든 스킬 상세
```

---

## Available Skills

### 🤖 agents/ - AI 에이전트

| 스킬 | 설명 |
|------|------|
| `background-implementer` | 백그라운드 병렬 구현 (컨텍스트 안전) |
| `background-planner` | 백그라운드 병렬 기획 (컨텍스트 안전) |
| `codex-implementer` | Codex CLI를 sub-agent로 활용한 구현 작업 |
| `multi-llm-agent` | 여러 LLM 통합 협업 (OpenAI, Gemini, Ollama) |
| `planning-agents` | 멀티 에이전트 병렬 기획 |
| `plan-executor` | 자동 플래닝 워크플로우 실행 |

### 🛠️ development/ - 개발 도구

| 스킬 | 설명 |
|------|------|
| `context-worktree` | 작업별 git worktree 자동 생성 |
| `git-commit-pr` | Git 커밋 및 PR 생성 가이드 |
| `multi-ai-code-review` | 멀티 AI 코드 리뷰 오케스트레이터 |
| `playwright` | Playwright 브라우저 자동화 |
| `pr-review-loop` | PR 리뷰 대기 및 자동 수정 |
| `task-master` | Task Master CLI 기반 작업 관리 |

### 📊 business/ - 비즈니스

| 스킬 | 설명 |
|------|------|
| `document-processor` | PDF, DOCX, XLSX, PPTX 문서 처리 |
| `proposal-analyzer` | 사업 제안서/RFP 분석 |

### 🔗 integrations/ - 외부 연동

| 스킬 | 설명 |
|------|------|
| `appstore-connect` | App Store Connect 자동화 |
| `discord-skill` | Discord REST API 관리 |
| `google-search-console` | Google Search Console API |
| `kubernetes-skill` | Kubernetes 클러스터 관리 |
| `notion-summary` | Notion 페이지 업로드 |
| `slack-skill` | Slack 앱 개발 및 API |

### 🧠 ml/ - ML/AI

| 스킬 | 설명 |
|------|------|
| `audio-pro

... (truncated)