name: manage-skills
description: 세션 변경사항을 분석하여 검증 스킬 누락을 탐지합니다. 기존 스킬을 동적으로 탐색하고, 새 스킬을 생성하거나 기존 스킬을 업데이트한 뒤 CLAUDE.md를 관리합니다.
disable-model-invocation: true
argument-hint: "[선택사항: 특정 스킬 이름 또는 집중할 영역]"

스킬 관리자

목적

.claude/skills/ 디렉토리를 일관되고 실행 가능한 상태로 유지한다.

1. 변경된 영역에 대한 검증 스킬 누락 탐지
2. 삭제/이동된 파일에 대한 잘못된 참조 탐지
3. 스킬 생성/업데이트/삭제 제안
4. verify-implementation, CLAUDE.md 동기화

탐지 대상

실행 절차

Step 1: 세션 변경 분석

변경된 파일 수집:

git diff HEAD --name-only
git log main..HEAD --name-only --pretty=format:""
git diff main...HEAD --name-only

최상위 영역별로 그룹화한다.

Step 2: 등록된 스킬과 매핑

변경된 파일을 각 verify 스킬의 커버리지 패턴과 대조.
각 파일을 COVERED, PARTIAL, UNCOVERED로 분류.

Step 3: 커버리지 갭 분석

각 관련 스킬에 대해:
- 누락된 파일 참조 확인
- 오래된 탐지 명령 확인
- 새 패턴이 기존 검사에 포함되는지 확인
- 삭제된 파일의 잔존 참조 확인
- 변경된 설정 값 확인

Step 4: CREATE vs UPDATE 결정

기존 스킬 도메인과 관련? → UPDATE
관련 파일 3개 이상이 공통 패턴 공유? → CREATE (새 verify 스킬)
그 외 → 면제 (검증 불필요)

Step 5: 기존 스킬 업데이트

• 기존에 작동하는 검사는 절대 삭제하지 않음 (추가만)
• 새 파일 참조, 탐지 명령, 워크플로우 스텝 추가
• 예외 조건 업데이트

Step 6: 새 스킬 생성

사용자 확인 후 생성. 규칙:
- verify- 프리픽스 필수
- kebab-case 명명
- SKILL.md 필수 섹션: 목적, 실행 시점, 관련 파일, 워크플로우, 출력 형식, 예외

생성 후 3곳 동기화:
1. .claude/skills/manage-skills/SKILL.md — 등록 테이블
2. .claude/skills/verify-implementation/SKILL.md — 실행 목록
3. CLAUDE.md — 스킬 테이블

Step 7: 검증

수정된 모든 SKILL.md를 재확인:
- 마크다운 포맷 검증
- 파일 참조가 실제 존재하는지 ls로 확인
- 탐지 명령을 dry-run 실행
- PASS/FAIL 기준이 명확한지 확인

Step 8: 요약 보고

## 스킬 관리 결과

### 분석된 변경 파일
- [파일 목록]

### 수행한 작업
| 스킬 | 작업 | 변경 내용 |
|------|------|-----------|
| verify-xxx | UPDATE/CREATE/DELETE | 설명 |

### 미커버 파일 (있을 경우)
- [파일 목록과 사유]

### 후속 권장 사항
- [있을 경우]

품질 기준

생성/업데이트된 스킬은 다음을 충족해야 한다:
- 실제 파일 경로가 ls로 확인됨
- 탐지 명령이 실제 grep/glob 패턴으로 동작함
- 각 검사에 명확한 PASS/FAIL 기준이 있음
- 최소 2~3개의 현실적 예외 조건이 있음
- 기존 스킬과 일관된 포맷을 따름