Skill Forge

---
name: skill-forge
description: Distill a hard problem you just solved into a reusable skill draft - proposal-only, behind a three-condition threshold. Use after finishing a non-trivial task whose procedure would otherwise die with the session. Trigger with /skill-forge.
disable-model-invocation: true
---

# Skill Forge — 성공 경험을 재사용 자산으로

kit의 학습 루프는 **비대칭**이다. 실패는 ledger → LESSONS 로 흐르는데,
성공은 아무 데도 안 남는다. 어려운 문제를 푼 세션의 절차 지식이 세션 종료와 함께
소멸하고, 다음에 같은 문제를 만나면 처음부터 다시 푼다.

이 스킬은 그 절반을 메운다 — 단, **아무 성공이나 스킬이 되지는 않는다.**

<HARD-GATE>
1. **proposal-only.** 사용자가 초안을 보고 **명시적으로 승인**하기 전에는
   스킬 디렉토리에 어떤 파일도 만들지 않는다. 초안은 대화창에만 존재한다.
2. **포징 임계 3조건 AND.** 하나라도 미충족이면 스킬을 만들지 않고 강등한다.
3. **자동 커밋 금지.** 커밋은 항상 사용자의 별도 결정이다.
</HARD-GATE>

> **산출 위치**: 승인된 스킬은 **이 프로젝트의 스킬 디렉토리**에 놓는다 — 하네스가 프로젝트
> 스킬을 읽는 곳(Claude Code: `.claude/skills/<name>/SKILL.md`). 어디인지 모르면 사용자에게
> 묻는다. 킷 플러그인 안(설치 캐시)에는 쓰지 않는다 — 업데이트 때 사라진다.

## 포징 임계 (3조건 — AND)

| 조건 | 판정 질문 | 미충족 시 강등 경로 |
| --- | --- | --- |
| **재현성** | 이 절차를 그 세션의 맥락 없이 그대로 다시 실행할 수 있는가? | **완료 보고에만 기록**한다(무엇을 풀었고 왜 스킬로 못 만드는지 한 줄). feedback ledger 에는 쓰지 않는다 — ledger 는 검증에서 **실제로 발견된 결함**만 받는 곳이고(`rules/feedback-loop.md`), 이 후보는 결함이 아니다 |
| **반복성** | 앞으로 **다시** 마주칠 문제인가? (1회성 마이그레이션·특정 사고 대응은 아니다) | 계획 파일(`docs/plans/*/plan.md`)이 있으면 그 `## 결정` 에, 없으면 완료 보고에 기록 |
| **비중복** | 기존 스킬로 커버되지 않는가? | 기존 스킬 **보강 제안**으로 전환 (새 스킬 만들지 않음) |

> 세 번째 조건이 가장 자주 걸린다. "새 스킬이 있으면 편하겠다"는 거의 항상
> "기존 스킬에 한 절이 빠져 있다"의 오독이다. 스킬 개수는 자산이 아니라 **비용**이다 —
> 트리거 맵이 커질수록 어느 것도 안 걸린다.

## 절차

### 1. 후보 서술 [건너뛰기 금지]

무엇을 풀었는지가 아니라 **"다음 사람이 같은 상황에서 무엇을 해야 하는가"**로 쓴다.
전자는 회고이고 후자만 스킬이다.

### 2. 3조건 판정 [건너뛰기 금지]

각 조건에 **근거와 함께** 판정을 적는다. "그럴 것 같다"는 판정이 아니다.

비중복 판정은 실제 목록과 대조한다:

- 이 세션에 노출된 스킬 목록(호스트가 보여 주는 이름·설명) — 킷과 다른 플러그인 스킬이 여기 있다
- 프로젝트·사용자 스킬 디렉토리(Claude Code: `.claude/skills/`, `~/.claude/skills/` — 없으면 건너뛴다)

> **다른 플러그인의 존재를 가정하지 않는다.** 다른 플러그인이 설치돼 있으면 그
> 목록과도 대조하고, 없으면 그 단계를 조용히 건너뛴다 (fail-open). 특정 플러그인이
> 있어야만 동작하는 절차는 consumer-first 위반이다.

미충족이면 **여기서 멈추고** 강등 경로를 실행한 뒤 보고한다.

### 3. 초안 작성 (파일로 남기지 않는다)

- frontmatter: `name`(kebab-case, 디렉토리 이름과 일치) · `description`(트리거 조건 포함,
  1024자 이하). **`model`·`effort` 는 넣지 않는다** — 스킬의 `effort` 는 로드한 세션의
  effort 를 세션 끝까지 덮어쓴다
- 본문: 사용 시점 표 → 절차(순서가 안전에 중요한 단계만 고정) → 실패 모드
- **정직한 한계 절을 반드시 넣는다** — 이 스킬이 보장하지 *않는* 것.

### 4. 사용자 승인 대기 [건너뛰기 금지]

초안 전문과 3조건 판정 근거를 함께 제시하고 승인을 받는다.
승인 없는 상태에서 다음 단계로 넘어가지 않는다.

### 5. 승인 후 적용

승인된 초안을 산출 위치에 쓴다. 프로젝트에 스킬 목록 문서·개수 검사·완료 게이트 같은 관례가
있으면 **함께** 갱신하고 그 게이트를 돌린다 — 파일 하나만 놓고 끝내면 그 관례가 조용히 낡는다.

## 정직한 한계

- 이 스킬은 **경험의 질을 판정하지 않는다.** 3조건은 "자산화할 가치가 있는가"의
  하한선일 뿐, 절차가 옳다는 보증이 아니다. 검증은 실사용이 한다.
- 새 스킬에는 행동 회귀 안전망(eval)이 **없다.** 이 스킬은 그것을 만들지 않는다.
- 결함 학습(ledger → LESSONS)과 역할이 다르다 — 그쪽은 **실패**를 회피 패턴으로 남기고,
  이쪽은 **성공**을 새 자산으로 승격한다.