@bottari/skills

보따리 팀의 휴대용 Claude Code 스킬 모음. 어느 repo에서나 한 줄로 설치한다 — 스킬을 그 repo의 .claude/skills/로 복사하고, 항상 적용되는 개발 플레이북을 CLAUDE.md 상단에 @-ref로 배선한다.

설치

대상 repo 루트에서:

npx @bottari/skills            # 모든 스킬
npx @bottari/skills boss       # 특정 스킬만

설치하면: .claude/playbook.md(always-on base) + .claude/skills/<스킬>/ 가 복사되고, CLAUDE.md 상단에 playbook @-ref 한 줄이 삽입된다(CLAUDE.md 없으면 생성, 있으면 나머지는 그대로 보존). 스킬은 clean mirror 라 재실행하면 그대로 재싱크. repo 가 같은 이름의 자체 스킬을 이미 갖고 있으면 건드리지 않고 보존한다(우리가 vendor 한 것만 재싱크).

복사·배선한 결과를 커밋하면, 팀원은 제품 repo만 클론해도 스킬이 딸려온다(vendor 방식). 업데이트는 npx @bottari/skills@latest <skill> 다시 돌리고 재커밋. idempotent라 여러 번 돌려도 안전.

사용법

스킬은 /이름으로 직접 부르거나(/spec, /boss …), description 의 자연어 트리거로 자동 발동한다(각 스킬 트리거는 아래). playbook.md 는 설치되면 항상 로드돼 코딩 내내 기본값이 되므로 따로 부를 필요 없다.

한 task 의 흐름:

1. /spec — 착수 전, 요구사항을 열린 질문 0 까지 인터뷰해 단단한 계획. (여기서 시작)
2. /spec-review — 그 계획이 아키텍처·high-stakes면, 짓기 전에 맥락 없는 새 눈으로 설계를 적대적 검토(최선인가·더 나은 대안). (작고 가역이면 생략)
3. 그 계획대로 개발(playbook 원칙이 always-on 가이드) — 결정이 막히면 /decide.
4. /boss — 완료·품질을 clean PASS 까지.
5. /e2e — 실제 앱 구동 검증(필요 시).
6. /distill-doc — 끝난 계획을 decision 으로 증류.

수록 스킬

• spec (/spec) — 착수 전, 요구사항을 열린 질문 0 까지 인터뷰해 실제 시스템에 발 딛고(추측 X) 단단한 계획(spec)을 만든다 — garbage-in 방지. boss 의 대칭 입력 게이트. 트리거: "계획 짜자" · "스펙 떠줘" · "이거 어떻게 만들지" · "요구사항 정리" · "기획".
• spec-review (/spec-review) — spec 이 낸 계획을 짓기 전에 맥락 없는 새 눈 여럿이 적대적으로 반박 — 그 아키텍처가 최선인가(그냥 되는 게 아니라)·더 나은 대안·헛된 의존성·낡은 best-practice 는 없나 — 판정(KEEP/CHANGE/NEEDS-DECISION). boss(완성 코드 검토)의 대칭 계획 게이트. scale-gate(작고 가역인 계획엔 생략). 트리거: "계획 검토" · "이 계획 최선이야?" · "짓기 전에 봐줘" · "아키텍처 반박" · "이대로 만들어도 돼?".
• boss (/boss) — task를 끝냈다 싶을 때, 정말 끝났고(plan 대비 누락·테스트·e2e) 정말 잘 짰는지(최선의 접근·임시 땜빵 없음·다음 개발 쉬운 구조)를 맥락 없는 새 눈으로 적대적으로 보고 clean PASS까지 가는 완료·품질 게이트(까다롭지만 네 편인 보스 톤). 어떤 스킬을 깔든 base로 함께 깔리는 playbook.md는 코딩 중 always-on 기본값이자 boss의 리뷰 기준(rubric). 트리거: "보스" · "다 됐는지 봐줘" · "누락 없나" · "이게 최선이야?" · "머지/커밋 전 점검".
• e2e (/e2e) — 프로젝트 환경(web/mobile/desktop)을 감지해 그에 맞는 실제 앱 e2e를 돌린다(LLM이 화면 보고 판단·조작). 트리거: "e2e 돌려" · "앱 띄워 확인" · "화면 보고 검증" · "스크린샷".
• distill-doc (/distill-doc) — 실행 완료된 docs/plans/ 계획 문서를 docs/decisions/ 토픽 문서로 증류하고 plan 제거. 트리거: "plan 증류" · "decisions 정리" · "문서 정돈".
• decide (/decide) — 결정이 막혔을 때(LLM이 물어보는데 나도 모를 때) 웹서치로 여러 각도 조사·비교해 근거 있는 최적 추천을 준다. 트리거: "결정해줘" · "이거 뭐가 나아?" · "모르겠어 찾아줘" · "조언".

개발

node bin/cli.js --target /path/to/target-repo boss   # publish 전 로컬 vendor

새 스킬 추가: skills/<name>/SKILL.md(+필요하면 references/)만 두면 CLI 가 자동 수록한다. 개발 플레이북은 레포 루트의 단일 playbook.md 한 파일 — 어떤 스킬을 깔든 base 로 항상 설치되고 CLAUDE.md 에 always-on @-ref 로 배선된다(--no-playbook 로 생략).