mysql-tuning-skill

mysql-tuning-skill

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

출처: 이 스킬은 2026 KRT Company 및 daalsoft@gmail.com 님의 자료를 기반으로 정리되었습니다.

---

포함된 스킬 목록

스킬	대상	설명
mysql-tuning-skill	MySQL (범용)	EXPLAIN, 인덱스, 조인, 트랜잭션/락, 모니터링
jpa-mysql-tuning-skill	JPA/Hibernate (Java/Kotlin)	N+1, Fetch Join, @BatchSize, DTO Projection
sqlalchemy-mysql-tuning-skill	SQLAlchemy (Python)	joinedload, selectinload, 커넥션 풀, 세션 관리
typeorm-mysql-tuning-skill	TypeORM (Node.js/TypeScript)	QueryBuilder, relations, bulk insert, synchronize

---

스킬 플러그인 설치 가이드

Claude Code에서 플러그인 설치

Claude Code CLI를 실행합니다.

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

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

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

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

claude plugin list

---

Codex에서 설치

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

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

방법 1: skill-installer로 설치

# Codex 채팅에서 skill-installer 사용 — 전체 스킬 설치
$skill-installer install https://github.com/Mineru98/mysql-tuning-skill/tree/main/skills/mysql-tuning-skill
$skill-installer install https://github.com/Mineru98/mysql-tuning-skill/tree/main/skills/jpa-mysql-tuning-skill
$skill-installer install https://github.com/Mineru98/mysql-tuning-skill/tree/main/skills/sqlalchemy-mysql-tuning-skill
$skill-installer install https://github.com/Mineru98/mysql-tuning-skill/tree/main/skills/typeorm-mysql-tuning-skill

필요한 스킬만 골라서 설치해도 됩니다. 각 스킬은 독립적으로 동작합니다.

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

Linux / macOS / Git Bash:

# 저장소 클론
git clone https://github.com/Mineru98/mysql-tuning-skill.git
cd mysql-tuning-skill

# 전체 스킬 설치 (프로젝트 단위)
mkdir -p .agents/skills
cp -r skills/* .agents/skills/

# 또는 전체 스킬 설치 (사용자 전역)
mkdir -p ~/.agents/skills
cp -r skills/* ~/.agents/skills/

Windows (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\* .agents\skills\

# 또는 전체 스킬 설치 (사용자 전역)
New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.agents\skills
Copy-Item -Recurse skills\* $env:USERPROFILE\.agents\skills\

개별 스킬만 설치

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

# MySQL 범용 (ORM 미사용)
cp -r skills/mysql-tuning-skill .agents/skills/

# 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/

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

# ~/.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:

# 저장소 클론
git clone https://github.com/Mineru98/mysql-tuning-skill.git
cd mysql-tuning-skill

# 전체 스킬 설치 (프로젝트 단위)
mkdir -p .cursor/skills
cp -r skills/* .cursor/skills/

# 또는 전체 스킬 설치 (사용자 전역)
mkdir -p ~/.cursor/skills
cp -r skills/* ~/.cursor/skills/

Windows (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\* .cursor\skills\

# 또는 전체 스킬 설치 (사용자 전역)
New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.cursor\skills
Copy-Item -Recurse skills\* $env:USERPROFILE\.cursor\skills\

개별 스킬만 설치하려면 skills/* 대신 skills/mysql-tuning-skill 등 원하는 스킬 폴더명을 지정하세요.

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

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

방법 3: 직접 폴더 복사

1. 이 저장소의 skills/ 폴더 안의 원하는 스킬 폴더를 복사 (전체 설치 시 모든 폴더)
2. .cursor/skills/ 또는 ~/.cursor/skills/ 에 붙여넣기
3. 각 스킬 폴더 내 SKILL.md 및 reference/*.md 파일 구조를 유지할 것

---

동작 원리

전체 아키텍처