← ClaudeAtlas

skill-forgelisted

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.
This-HW/claude-code-kit · ★ 4 · AI & Automation · score 80
Install: claude install-skill This-HW/claude-code-kit
# Skill Forge — 성공 경험을 재사용 자산으로 kit의 학습 루프는 **비대칭**이다. 실패는 ledger → LESSONS → `/self-improve`로 흐르는데, 성공은 아무 데도 안 남는다. 어려운 문제를 푼 세션의 절차 지식이 세션 종료와 함께 소멸하고, 다음에 같은 문제를 만나면 처음부터 다시 푼다. 이 스킬은 그 절반을 메운다 — 단, **아무 성공이나 스킬이 되지는 않는다.** <HARD-GATE> 1. **proposal-only.** 사용자가 초안을 보고 **명시적으로 승인**하기 전에는 `plugins/common/skills/` 아래에 어떤 파일도 만들지 않는다. 초안은 대화창 또는 `docs/works/idea/` 에만 존재한다. 2. **포징 임계 3조건 AND.** 하나라도 미충족이면 스킬을 만들지 않고 강등한다. 3. **자동 커밋 금지.** 커밋은 항상 사용자의 별도 결정이다. </HARD-GATE> > **적용 범위**: 승인 후 적용 단계(스킬 파일 생성 + 3표면 동기화 + 카운트/버전 게이트)는 > **kit 레포 자체의 개발**을 전제한다. 소비자 프로젝트에서는 3조건 판정과 초안 작성까지가 > 유효하며, 산출한 초안은 그 프로젝트의 `.claude/skills/`에 사용자가 직접 배치한다. ## 포징 임계 (3조건 — AND) | 조건 | 판정 질문 | 미충족 시 강등 경로 | | --- | --- | --- | | **재현성** | 이 절차를 그 세션의 맥락 없이 그대로 다시 실행할 수 있는가? | `./scripts/feedback.sh upsert`로 ledger 한 줄 | | **반복성** | 앞으로 **다시** 마주칠 문제인가? (1회성 마이그레이션·특정 사고 대응은 아니다) | Work 문서(`progress.md`/`decisions.md`)에 기록 | | **비중복** | 기존 스킬로 커버되지 않는가? | 기존 스킬 **보강 제안**으로 전환 (새 스킬 만들지 않음) | > 세 번째 조건이 가장 자주 걸린다. "새 스킬이 있으면 편하겠다"는 거의 항상 > "기존 스킬에 한 절이 빠져 있다"의 오독이다. 스킬 개수는 자산이 아니라 **비용**이다 — > 트리거 맵이 커질수록 어느 것도 안 걸린다. ## 절차 ### 1. 후보 서술 [건너뛰기 금지] 무엇을 풀었는지가 아니라 **"다음 사람이 같은 상황에서 무엇을 해야 하는가"**로 쓴다. 전자는 회고이고 후자만 스킬이다. ### 2. 3조건 판정 [건너뛰기 금지] 각 조건에 **근거와 함께** 판정을 적는다. "그럴 것 같다"는 판정이 아니다. 비중복 판정은 실제 목록과 대조한다: ```bash ls plugins/common/skills/ # kit 스킬 ls ~/.claude/plugins/*/*/skills/ 2>/dev/null # 설치된 다른 플러그인 (없으면 건너뛴다) ``` > **다른 플러그인의 존재를 가정하지 않는다.** su