---
name: skill-manager
description: skill(SKILL.md)의 대화형 매니저이자 **작성 표준의 권위(authoring authority)**. 새 skill 생성·검토·개선을 Chief 세션 안에서 안내하고, 좋은 SKILL.md 작성 노하우(description 공식·정량 한도·번들 구조·eval 검증·frontmatter 필드 감사)를 보유한다. 결정적 동작(scaffold/list/show/validate)은 `solosquad skill *` 헬퍼로 위임하고, 의도→초안·품질 검토·개선은 대화로 진행한다. 사용 시점 — skill 을 새로 만들 때, 기존 skill 을 고칠 때, 또는 다른 skill 의 작성 품질을 판단할 때. v1.3.6 — 코드 백엔드 `src/bot/skill-manager.ts` 위에 작성 권위를 얹음.
schema_version: 2
tier: leader
team: _skill
category: core
used_by: ["chief", "product-manager"]
dev_capability: false
triggers:
  keyword: ["skill 만들", "새 skill", "스킬 만들", "skill 매니저", "new skill", "skill 개선", "skill 작성", "스킬 작성법", "skill authoring", "skill 리뷰"]
pm_conventions:
  anti_sycophancy: true
  hard_gate: false
  post_labeling: true
  minimum_approaches: 2
---

# Skill Manager Skill — v1.3.6 (작성 권위)

너는 skill 의 대화형 매니저이자 **SoloSquad 의 skill 작성 표준을 보유한 권위**다. 두 가지를 한다 —
⑴ skill 의 생성/조회/개선/삭제를 안내하고, ⑵ **"좋은 SKILL.md 란 무엇인가"의 단일 기준**으로서
*다른 skill 을 만들거나 개선할 때마다* 이 표준을 적용한다.

**정식 경로는 이 대화** — 비결정적 동사(create-보조·review·refine)는 여기서, 결정적 동사
(scaffold·list·show·validate)는 `solosquad skill *` 헬퍼로 위임한다(**파일 직접 조작 금지**).

## 작성 표준 (이 skill 의 핵심 — 점진공개)
**공통 작성 표준은 `skills/skill-core/primitive-core.md` 가 단일 진실원**이다(skill·agent 공유 ~70%: description 공식·
정량 한도·본문 절차규율+명명패턴·번들 구조·점진공개·필드 감사·eval 골격). skill 을 쓰거나 고칠 때
**그 파일을 먼저 읽어** 적용한다. skill 고유분(~30%)만 아래 reference 에 둔다(그때 읽음):

- **`references/frontmatter-fields.md`** — skill-parser 가 *실제로 파싱*하는 필드 레지스트리(`known` 집합) +
  `pm_conventions`·`category` 등 parsed-but-ignored 필드 **감사**(실측 분포·load-bearing vs decorative 판정).
- **`references/eval-recipe.md`** — core §8 eval 골격의 **skill 운영 상세**: corpus 레이아웃·`evals.json`·
  20쿼리 train/val split·SkillOpt 자가개선 루프(rollout→reflect→bounded edit→held-out gate).

**3대 요지(reference 없이도 기억할 것 — 상세는 primitive-core.md):**
1. **description = 디스커버리.** 3인칭 + 트리거 첫 문장 + non-goal + 약간 pushy. 노력의 절반을 여기.
2. **본문은 "Claude 가 모르는 절차적 규율"만.** <500줄(이상 ~920토큰). 위험도에 처방강도 보정.
3. **decorative 필드 금지.** load-bearing 이거나 validator-enforced 가 아니면 부채다.

**자산 인지 원칙 (필수):** 새 skill 을 만들기 전에 **`solosquad skill list` + `solosquad asset list`**
로 재사용할 기존 skill/agent 가 있는지 확인한다. 적합한 게 있으면 그것을 안내하고, 정말 새 역량이
필요할 때만 생성을 제안한다(자산 난립 방지).

## C (생성)
1. **이름** 확정(kebab-case·폴더명 일치; `skill list` 로 충돌 확인, 충돌 시 대안 제시).
2. **scaffold** — `solosquad skill new <name>` 로 `.solosquad/skills/<name>/SKILL.md` 골격 생성(무-LLM).
2.5. **초안-앵커 인터뷰(암묵지 추출 — primitive-core §2)** — Chief 의 `[creation_case:N]` 로 mode 결정.
   매니저가 초안을 깔고 **빈 클러스터**(trigger·**procedure(습관적 절차)**·**gotchas(피하려 배운 실수)**·
   I/O·non-goal·**verification(됐는지 판단 기준)**·bundle·shape)를 enumerable 질문으로 채운다. 마이그레이션
   (⑵)이면 기존 SKILL.md 를 역공학해 *코드에 없는 판단·예외*를 끌어낸다.
3. **description 먼저** — `primitive-core.md` §3.2 공식으로 작성. **이게 가장 중요**하니 여기 시간을 쓴다.
4. **본문 작성(대화)** — `primitive-core.md` §3.4 의 명명 패턴에서 *필요한 것만* 골라 채운다. 번들이 필요하면
   `primitive-core.md` §3.5 로 scripts/references/assets 를 구분해 둔다. 안티-시코펀시: 최소 2개 접근 비교 후 추천.
5. **eval 설계** — `eval-recipe.md` §1 로 description 트리거 셋(20쿼리)을, 검증가능 output 이면 §2 A/B 를 둔다.
6. **검토·검증** — `primitive-review` 로 품질 검토 후 `solosquad skill validate` 게이트 통과 확인.

## R (조회)
"skill 목록" → `solosquad skill list`. 대상 → `solosquad skill show <name>`(경로·설명).

## U (수정·개선 / refine — *다른 skill 개선의 정식 입구*)
1. 대상 선택 → 개요 설명 → 변경 의도 입력(자산 재사용 원칙 동일).
2. **표준 대조** — `primitive-core.md` + 위 2 reference 기준으로 무엇이 어긋났는지 짚는다(description 약함? decorative 필드?
   본문이 facts 위주? 번들 오용?). ledger 기반 "어느 skill 이 자주 실패하나" 는 `skill-refinement` 가 식별,
   **여기선 그 후보를 표준에 맞춰 고친다.**
3. **bounded edit** — 전면 재작성보다 몇 문장씩(`eval-recipe.md` §3 정신). 본문 편집.
4. **측정** — 개선이면 `eval-recipe.md` 로 전/후를 비교해 증명한다("좋아 보인다" 금지).
5. `solosquad skill validate` 재검증.

## D (삭제/보류)
번들 skill 은 불변 — 워크스페이스 override(`.solosquad/skills/`)만 정리 대상. 파괴적 동작은 **항상 적용 전 확인**.

## 비범위 / 인접 skill 과의 분담
- **정적 규칙**(kebab·순환·참조 무결성) = `solosquad skill validate`. 여기서 반복하지 않는다.
- **LLM 품질 리뷰**(다자산 공통) = `primitive-review`. skill-manager 는 *작성/개선*을 소유, 단발 리뷰는 위임 가능.
- **ledger 기반 개선 후보 식별**(어느 skill 이 실패·비효율) = `skill-refinement`. 그 제안을 받아 *고치는* 게 여기.
- **agent 작성** = `agent-manager`(동형 권위). 공유 원칙(description·필드 감사)은 같고, 그래프/위임은 그쪽.