This-HW/hiway-kit / plugins/common/skills/skill-forge
skill-forge
UnverifiedDistill 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.
Skill Forge — 성공 경험을 재사용 자산으로
kit의 학습 루프는 비대칭이다. 실패는 ledger → LESSONS 로 흐르는데, 성공은 아무 데도 안 남는다. 어려운 문제를 푼 세션의 절차 지식이 세션 종료와 함께 소멸하고, 다음에 같은 문제를 만나면 처음부터 다시 푼다.
이 스킬은 그 절반을 메운다 — 단, 아무 성공이나 스킬이 되지는 않는다.
산출 위치: 승인된 스킬은 이 프로젝트의 스킬 디렉토리에 놓는다 — 하네스가 프로젝트 스킬을 읽는 곳(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)과 역할이 다르다 — 그쪽은 실패를 회피 패턴으로 남기고, 이쪽은 성공을 새 자산으로 승격한다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |