setup-skillslisted
Install: claude install-skill gagip/gagip-dev
## 목적
프로젝트마다 언어, 프레임워크, 도메인이 다르다. principles.md의 원칙은 범용적이지만, 실제 코드에 적용하려면 프로젝트 맥락에 맞는 구체적인 지침이 필요하다. 이 스킬은 추상적 원칙을 프로젝트 특화 스킬로 변환하는 다리 역할을 한다.
## 작업 순서
### 1단계: 원칙 문서 로드
이 스킬 파일과 같은 디렉토리의 `references/` 아래 원칙 문서를 읽는다.
| 파일 | 내용 |
| --- | --- |
| `fundamentals.md` | 근본 원칙 — 모든 스킬이 참조하는 기반 |
| `code.md` | 자명한 코드 — 코드 레벨 실천 |
| `testing.md` | 테스트 전략 — 검증 원칙 |
| `ai-collaboration.md` | AI 협업 — 하네스와 역할 분담 |
| `vsa/vsa-common.md` | VSA 공통 아키텍처 — 모든 플랫폼에 적용되는 슬라이스 기반 원칙 |
| `vsa/vsa-android.md` | VSA Android — Kotlin + Hilt 프로젝트 적용 규칙 |
| `vsa/vsa-flutter.md` | VSA Flutter — Dart + Riverpod 프로젝트 적용 규칙 |
| `vsa/vsa-godot.md` | VSA Godot — GDScript 프로젝트 적용 규칙 |
추천/생성할 스킬 유형에 따라 관련 원칙 문서만 참조한다. `fundamentals.md`는 항상 읽는다. 아키텍처 관련 스킬이라면 `vsa/vsa-common.md`도 항상 읽고, 플랫폼이 특정되면 해당 vsa 문서(android/flutter/godot)를 추가로 읽는다.
원칙은 언제든 수정될 수 있다. 이 스킬을 다시 실행하면 현재 원칙과 기존 커스텀 스킬 사이의 차이를 감지하고, 업데이트가 필요한 스킬을 알려준다.
### 2단계: 프로젝트 분석
프로젝트의 성격을 파악한다. 아래 항목을 순서대로 확인한다.
**기본 정보 수집:**
- 빌드 파일 / 패키지 매니저 (`build.gradle.kts`, `package.json`, `Cargo.toml`, `pyproject.toml` 등)
- 주요 언어 및 프레임워크
- 디렉토리 구조 (src 레이아웃, 모듈 구성)
- 기�� CLAUDE.md 유무 및 내용
- 기존 `.claude/skills/` 유무
**심화 분석 (스킬 2개 이상 구체적으로 추천할 수 있을 때까지):**
- 코드 패턴 샘플링 (핵심 모듈 2~3개의 코드 스타일)
- 테스트 구조 및 컨벤션
- 에러 처리 패턴
- 상태 관리 방식
위 조건을 충족하면 분석을 멈추고 다음 단계로 진행한다. 확신이 없으면 사용자에게 질문한다.
### 3단계: 기존 스킬 점검 및 추천
먼저 프로젝트에 이미 생성된 커스텀 스킬(`.claude/skills/`)이 있는지 확인한다.
**기존 스킬이 있는 경우:** `references/`의 원칙 문서와 기존 스킬의 내용을 직접 비교한다. 아래 기준으로 모순을 찾는다.
- 스킬이 권장하는 패턴이 원칙 문서의