mysql-tuning-skill

# mysql-tuning-skill

MySQL 쿼리 성능 튜닝 및 최적화를 위한 AI 에이전트 스킬입니다.

> **출처**: 이 스킬은 **2026 KRT Company** 및 **[email protected]** 님의 자료를 기반으로 정리되었습니다.

---

## 스킬 플러그인 설치 가이드

### Claude Code에서 플러그인 설치

Claude Code CLI를 실행합니다.

다음 명령어로 플러그인을 설치합니다:

```bash
# 마켓플레이스 추가
claude plugin marketplace add Mineru98/mysql-tuning-skill
# 또는 채팅에서
/plugin marketplace add Mineru98/mysql-tuning-skill
```

```bash
# 플러그인 설치
claude plugin install mysql-tuning-skill
# 또는 채팅에서
/plugin install mysql-tuning-skill
```

설치 후 사용 가능한 스킬을 확인합니다:

```bash
claude plugin list
```

---

### Codex에서 설치

OpenAI Codex는 다음 경로에서 스킬을 자동으로 스캔합니다:

| 경로 | 범위 |
|------|------|
| `$CWD/.agents/skills/` | 프로젝트 단위 |
| `~/.agents/skills/` | 사용자 전역 |

#### 방법 1: skill-installer로 설치

```bash
# Codex 채팅에서 skill-installer 사용
$skill-installer install https://github.com/Mineru98/mysql-tuning-skill/tree/main/skills/mysql-tuning-skill
```

#### 방법 2: 수동 설치 (Git Clone)

**Linux / macOS / Git Bash:**
```bash
# 저장소 클론
git clone https://github.com/Mineru98/mysql-tuning-skill.git
cd mysql-tuning-skill

# 프로젝트에 설치 (프로젝트 내 사용자만 적용)
mkdir -p .agents/skills
cp -r skills/mysql-tuning-skill .agents/skills/

# 또는 사용자 전역 설치 (모든 프로젝트에서 사용)
mkdir -p ~/.agents/skills
cp -r skills/mysql-tuning-skill ~/.agents/skills/
```

**Windows (PowerShell):**
```powershell
# 저장소 클론
git clone https://github.com/Mineru98/mysql-tuning-skill.git
cd mysql-tuning-skill

# 프로젝트에 설치
New-Item -ItemType Directory -Force -Path .agents\skills
Copy-Item -Recurse skills\mysql-tuning-skill .agents\skills\

# 또는 사용자 전역 설치
New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.agents\skills
Copy-Item -Recurse skills\mysql-tuning-skill $env:USERPROFILE\.agents\skills\
```

#### ORM별 스킬 설치

필요한 ORM 스킬만 선택해서 설치할 수 있습니다:

```bash
# JPA/Hibernate (Java/Kotlin, Spring Boot)
cp -r skills/jpa-mysql-tuning-skill .agents/skills/

# SQLAlchemy (Python)
cp -r skills/sqlalchemy-mysql-tuning-skill .agents/skills/

# TypeORM (Node.js/TypeScript)
cp -r skills/typeorm-mysql-tuning-skill .agents/skills/
```

#### 스킬 비활성화 (삭제하지 않고)

```toml
# ~/.codex/config.toml
[[skills.config]]
path = "/path/to/mysql-tuning-skill/SKILL.md"
enabled = false
```

---

### Cursor에서 설치

Cursor는 다음 경로에서 스킬을 자동으로 로드합니다:

| 경로 | 범위 |
|------|------|
| `.cursor/skills/` | 프로젝트 단위 |
| `.agents/skills/` | 프로젝트 단위 |
| `~/.cursor/skills/` | 사용자 전역 |

#### 방법 1: 수동 설치 (Git Clone)

**Linux / macOS / Git Bash:**
```bash
# 저장소 클론
git clone https://github.com/Mineru98/mysql-tuning-skill.git
cd mysql-tuning-skill

# 프로젝트에 설치 (프로젝트 내 사용자만 적용)
mkdir -p .cursor/skills
cp -r skills/mysql-tuning-skill .cursor/skills/

# 또는 사용자 전역 설치 (모든 프로젝트에서 사용)
mkdir -p ~/.cursor/skills
cp -r skills/mysql-tuning-skill ~/.cursor/skills/
```

**Windows (PowerShell):**
```powershell
# 저장소 클론
git clone https://github.com/Mineru98/mysql-tuning-skill.git
cd mysql-tuning-skill

# 프로젝트에 설치
New-Item -ItemType Directory -Force -Path .cursor\skills
Copy-Item -Recurse skills\mysql-tuning-skill .cursor\skills\

# 또는 사용자 전역 설치
New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.cursor\skills
Copy-Item -Recurse skills\mysql-tuning-skill $env:USERPROFILE\.cursor\skills\
```

#### 방법 2: GitHub 원격 규칙으로 설치

1. Cursor에서 **Settings** → **Rules** 이동
2. **Add Rule** 클릭
3. **Remote Rule (Github)** 선택
4. 저장소 URL 입력: `https://github.com/Mineru98/mysql-tuning-skill`
5. 경로: `mysql-tuning-skill` (스킬 폴더 지정)

#### 방법 3: 직접 폴더 복사

1. 이 저장소의 `skills/mysql-tuning-skill` 폴더 전체를 복사
2. `.cursor/skills/mysql-tuning-skill` 또는 `~/.cursor/skills/mysql-tuning-skill` 에 붙여넣기
3. `SKILL.md` 및 `*.md` 레퍼런스 파일이 포함된 구조를 유지할 것

---

## 사용 방법

- **자동 적용**: MySQL 쿼리 성능, EXPLAIN, 인덱스, 조인 튜닝 등 관련 요청 시 에이전트가 자동으로 스킬을 적용합니다.
- **수동 호출**: Agent 채팅에서 `/` 입력 후 `mysql-tuning` 검색하여 직접 호출할 수 있습니다.

---

## 라이선스

MIT License