Multi-runtime skill collection for Claude Code and OpenAI Codex, with 18 custom skills + 2 agents for thinking, deciding, and building smarter. 생각하고, 결정하고, 더 나은 결과로 빌드하기 위한 Claude Code / OpenAI Codex 호환 스킬 모음 — 18개 스킬 + 2개 에이전트.
목표는 특정 런타임 하나에 갇힌 명령 모음이 아니라, 같은 스킬 원본과 작업 철학을 Claude Code와 Codex 양쪽에서 범용적으로 재사용하는 것이다. Claude Code에서는 플러그인 스킬/에이전트로, Codex에서는 20개 슬래시 커맨드와 AGENTS.md 라우팅으로 동작한다 (codex/ 참고).
- Quick Start
- Guardrails
- Available Skills
- Skill Details
- Agents
- Subagent Rules
- Writing Your Own Skill
- License
Claude Code와 Codex 사용자는 플러그인으로 설치한다. codex/ 어댑터는 슬래시 커맨드 변환본과 legacy ~/.codex/ 직접 연결 스크립트를 제공하지만, 중복 로딩을 피하려면 Codex 플러그인 설치본을 기본 실행 표면으로 둔다.
# 마켓플레이스에서 플러그인 추가
claude plugin marketplace add kingkingburger/plugin-mh
# 플러그인 설치
claude plugin install plugin-mh설치 확인:
claude plugin list목록에 plugin-mh가 보이면 완료. 설치된 Claude plugin cache가 현재 repo의 skill/agent 표면과 같은지도 validate-plugin -ClaudeInstalled로 확인한다.
Codex CLI에서도 같은 스킬 흐름을 쓰려면 marketplace를 추가하고 플러그인을 설치한다.
codex plugin marketplace add kingkingburger/plugin-mh
codex plugin add plugin-mh@plugin-mh업데이트는 repo 변경을 push한 뒤 codex plugin marketplace upgrade plugin-mh로 갱신한다. 자세한 내용과 legacy adapter 설치는 codex/README.md를 참고한다.
guardrails/는 MH의 개인 엔지니어링 하네스 규칙이다 — 언어별 기본값, TDD/리뷰 절차, 소프트웨어 공학 법칙 기반 행동 규칙.
| 영역 | 파일 |
|---|---|
| 공통 작업 원칙 | guardrails/core.md |
| 소프트웨어 공학 법칙 | guardrails/laws.md |
| TypeScript 선호 | guardrails/languages/typescript.md |
| Rust 선호 | guardrails/languages/rust.md |
| Python 선호 | guardrails/languages/python.md |
| TDD 절차 | guardrails/workflows/tdd.md |
| 리뷰 절차 | guardrails/workflows/review.md |
검증:
# Windows PowerShell
.\scripts\validate-plugin.ps1
# macOS / Linux / Git Bash
bash scripts/validate-plugin.sh설치된 Claude/Codex 표면까지 확인하려면:
# Windows PowerShell
.\scripts\validate-plugin.ps1 -Installed
# macOS / Linux / Git Bash
bash scripts/validate-plugin.sh --installed| Skill | Trigger | Description |
|---|---|---|
| grill-me | grill me, 설계 압박 질문, --docs |
구현 전에 계획/설계를 stress-test. --docs는 glossary/ADR까지 정리 |
| vague | 요구사항 정리, 명확히, spec this out |
모호한 요구사항을 가설 기반 질문으로 구체적 스펙으로 변환 |
| unknown | blind spots, 4분면 분석 |
Known/Unknown 4분면으로 전략 사각지대 발견 |
| moonshot | moonshot, 10x, 더 높은 목표 |
목표 성격에 맞는 프레임워크로 상향 목표 제안 |
| ouroboros | ouroboros, 심층 문서, 계획 실행 |
요구사항→설계→검증→실행 4단계. 체크리스트 게이트 + Generator-Evaluator 루프 |
| Skill | Trigger | Description |
|---|---|---|
| tech-decision | A vs B, 기술 선택 |
기술 의사결정을 페르소나 4종 + WebSearch로 체계적 분석 |
| agent-arena | 에이전트 토론, debate this |
역할별 페르소나가 다라운드 토론 후 종합자가 결론 |
| expert-review | 전문가 리뷰, expert review |
전문가 페르소나 자동 추천 → 병렬 리뷰 → 통합 제안 |
| Skill | Trigger | Description |
|---|---|---|
| tdd | tdd, 테스트 먼저 |
RED-GREEN-REFACTOR 강제 — 실패하는 테스트 없이 프로덕션 코드 금지 |
| review-loop | 리뷰 루프, review-loop |
Tiered 리뷰 — code-reviewer 단독 → 필요 시 architect+critic 페르소나 병렬 |
| ai-slop-cleaner | deslop, AI 슬롭, 슬롭 정리 |
AI 슬롭 코드 정리 — 회귀 안전, 삭제 우선, 한 종류씩. --review 지원 |
| live-verify | 라이브 검증, live-verify |
Plan/Run 2단계 E2E 검증. 수정 예산 + 회귀 가드 + 증거 강제 |
| find-pulp | find-pulp, 규칙 충돌, 과도한 탐색 |
스킬·AGENTS·Codex 프롬프트·메모리의 충돌, 과도한 탐색, drift 감사 및 저위험 개선 |
| Skill | Trigger | Description |
|---|---|---|
| auto-commit | 자동 커밋, auto commit |
작업 실행 후 변경 성격별 git commit, 명시 요청 시 push |
| skill-manage | 스킬 관리, skill-add, skill-delete |
스킬 추가/삭제/이름변경 + 메타데이터·교차참조 원자적 동기화 |
| Skill | Trigger | Description |
|---|---|---|
| session-closing | /closing, /wrap |
세션 마무리 — 페르소나 4종 병렬 분석 + 중복 검증 + 액션 |
| closing-lite | /closing-lite, 라이트 클로징 |
30초 경량 마무리 — 메모리 누적 전용 |
| Skill | Trigger | Description |
|---|---|---|
| youtube-slides | youtube-slides, 자막 캡쳐, 영상 요약 |
slides(프레임 캡쳐) / digest(요약·번역·9문항 퀴즈) / both |
계획/설계를 구현 전에 집요한 질문으로 stress-test.
한 번에 1-3개 질문만 던지고, 각 질문에 추천 답변을 붙여 사용자가 빠르게 수락·수정·거절할 수 있게 한다. 코드베이스에서 답을 찾을 수 있는 내용은 먼저 탐색하고, 확인된 사실과 계획이 충돌하면 그 충돌을 질문의 출발점으로 삼는다.
두 가지 모드
| 모드 | 하는 일 |
|---|---|
| 기본 | 질문만. 문서를 쓰지 않는다 |
--docs |
저장소의 CONTEXT-MAP.md / CONTEXT.md / docs/adr/ / 코드를 질문의 기준으로 삼고, 확정된 용어를 CONTEXT.md glossary에 반영. ADR은 되돌리기 어렵고·맥락 없이 놀랍고·실제 대안이 있었던 결정에만 제안 |
Trigger: grill-me, grill me, 계획을 까다롭게 질문해줘, 설계 압박 질문, stress-test my plan, grill with docs, 문서랑 맞춰 질문, ADR까지 정리
User: "grill me - 이 결제 리팩터링 계획 괜찮은지 압박 질문해줘"
User: "/grill-me 새 권한 모델 설계"
User: "grill me --docs - 주문 취소 정책을 도메인 문서 기준으로 검토해줘"모호한 요구사항을 가설 기반 질문으로 구체적 스펙으로 변환.
열린 질문 대신 선택 가능한 가설을 제시해 인지 부하를 줄인다.
- Capture — 원래 요구사항을 그대로 기록
- Question — 가설 옵션이 포함된 5–8개 질문으로 모호성 해소
- Compare — Before/After 비교 제시
- Save — 명확화된 스펙을 파일로 저장 (선택)
| Before | After |
|---|---|
| "로그인 기능 추가해줘" | Goal: Email+Password 로그인. Scope: 로그인, 로그아웃, 회원가입, 비밀번호 재설정. Constraints: 24h 세션, bcrypt, 5회 시도 제한. |
Known/Unknown 4분면으로 전략 사각지대를 발견.
3라운드 심화 질문으로 숨겨진 가정을 체계적으로 드러낸다.
| Round | 목적 | 질문 수 |
|---|---|---|
| R1 | 초안 검증 | 3–4개 (모든 분면 커버) |
| R2 | 약점 심화 | 2–3개 (R1 답변 기반 타겟팅) |
| R3 | 실행 세부 (선택) | 2–3개 |
Output: 4분면 매트릭스 + 실험 설계 + 실행 로드맵
User: "이 분기 사업 계획 blind spots 점검해줘"
User: "마이크로서비스 전환 전략에서 뭘 놓치고 있지?"목표 성격에 맞는 프레임워크를 적용해 최고 수준의 상향 목표를 제안.
하나의 상향 목표만 제안하며, 왜 이 수준이 가능한지 논리적 근거를 함께 제시한다.
Trigger: moonshot, 10x, 더 높은 목표, stretch goal, BHAG, think bigger
User: "이번 분기 매출 목표 1000만원인데 더 높게 잡고 싶어"
User: "moonshot - DAU 목표를 상향해줘"기술 의사결정을 4개 병렬 에이전트로 체계적으로 분석.
두괄식 결과물 — 결론을 먼저 제시하고 근거를 뒤에 배치한다.
Phase 1: Parallel Information Gathering
┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│ codebase- │ docs- │ WebSearch │ agent-arena │
│ explorer │ researcher │ (community) │ (multi-view) │
└────────┬────────┴────────┬────────┴────────┬────────┴────────┬────────┘
└─────────────────┴─────────────────┴─────────────────┘
│
Phase 2: Analysis & Synthesis ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ decision-synthesizer │
│ (Executive Summary First) │
└─────────────────────────────────────────────────────────────────────────┘
User: "React vs Vue for my new project?"
User: "Prisma vs TypeORM 비교 분석해줘"
User: "Monolith vs Microservices for our scale?"역할별 에이전트들이 다라운드 토론을 벌이고 종합자가 결론을 도출.
| Preset | Agents | Use Case |
|---|---|---|
| 3인 (기본) | 3 | 간단한 비교 |
| 5인 | 5 | 기능/방향성 검토 |
8인 (--preset 8) |
8 | 전략적 심층 분석 |
User: "agent-arena - 모놀리스 vs 마이크로서비스?"
User: "에이전트 토론 --preset 8 - MVP 스코프를 어디까지?"파일을 입력하면 전문가 페르소나를 자동 추천하고 병렬 리뷰 후 통합 제안서를 출력.
Step 1: 파일 읽기 → 문서 유형/도메인 분석
Step 2: 최적 전문가 N명 자동 추천 → 사용자 확인/수정
Step 3: N명 병렬 서브에이전트 리뷰 (등급 + 강점 + 개선 제안)
Step 4: 통합 제안서 (공통 평가 + 충돌 해소 + 우선순위 액션 아이템)
| Option | Default | Description |
|---|---|---|
--count |
3 |
리뷰어 수 (2~5) |
--auto |
false |
페르소나 확인 단계 생략 |
--save |
true |
결과 파일 저장 |
Trigger: 전문가 리뷰, expert review, 페르소나 리뷰, 다관점 리뷰
User: "/expert-review docs/plan.md"
User: "/expert-review src/main.ts --count 5"
User: "전문가 리뷰 부탁 - README.md"지시한 작업을 수행한 후 변경 성격별로 묶어 근거 있는 git commit.
작업 → 검증 → 커밋 단위 설계 → 커밋 메시지 작성 → 커밋을 하나의 흐름으로 자동화한다. git push는 사용자가 푸시, push, 커밋푸시처럼 명시적으로 요청한 경우에만 수행한다.
큰 diff는 코드 성격, 변경 의도, runtime boundary를 기준으로 여러 커밋으로 나누고, 커밋 본문에는 무엇을 바꿨는지, 왜 바꿨는지, 제외한 범위를 남긴다. 검증 결과는 커밋 메시지가 아니라 최종 응답에 보고한다.
User: "자동 커밋 - README 오타 수정해줘"
User: "auto commit - fix the login bug"구현된 기능을 실제 사용자처럼 테스트하는 2-Phase E2E 검증.
Phase 1 (Plan): 작업 계획/PRD/코드 분석 → 검증 시나리오 자동 생성
Phase 2 (Run): Playwright/Bash/curl로 실제 제품 조작 → 실패 시 자동 수정 + 재검증
판정 4종: PASS / FAIL / FLAKY(재실행 통과 — 코드 안 고침) / BLOCKED(외부 의존으로 실행 불가 — 제품 결함 아님). FAIL 확정 전 반드시 1회 재실행해 타이밍 오탐을 걸러낸다.
안전장치
| 장치 | 내용 |
|---|---|
| 수정 예산 | 시나리오당 5회, 세션 합계 20회. 동일 가설 2회 실패 시 가설 전환 |
| 회귀 가드 | 코드를 고쳤으면 다음 시나리오 전에 이미 PASS한 시나리오를 다시 돌린다. 공유 모듈·API 계약을 건드렸으면 전체 재실행 |
| 수정 범위 화이트리스트 | 시나리오 파일·테스트 assertion·설정·CI·무관 모듈·인증 파일은 사용자 확인 없이 수정 금지 |
| 증거 강제 | 관측값(스냅샷 텍스트·stdout·HTTP 응답) 인용 없이 PASS 선언 금지. 웹 시나리오는 스크린샷 필수 |
| 은폐 금지 | 기대결과를 실제 결과에 맞춰 낮추지 않는다. 시나리오가 틀렸다면 멈추고 확인 |
User: "/live-verify" # Phase 자동 감지
User: "/live-verify plan" # Phase 1만 실행
User: "/live-verify run" # Phase 2만 실행스킬 추가/삭제/이름변경을 수행하면서 메타데이터 파일과 다른 SKILL.md의 교차참조를 원자적으로 동기화.
스킬 하나를 삭제할 때 수정해야 하는 파일:
CLAUDE.md— "스킬 목록 (N개)" + 테이블 행README.md— 첫 줄 카운트 + TOC + 카테고리 테이블 + 상세 섹션 (4 위치).claude-plugin/marketplace.json— 설명 개수 + 스킬명 리스트GUIDE.md— Marketplace 등록 예시codex/prompts/<name>.md+codex/AGENTS.md카탈로그·라우팅- 다른
skills/*/SKILL.md— description 트리거 + 본문 교차참조
수동으로 하면 10+ edit. 이 스킬이 워크플로우를 가이드해 누락을 방지한다.
역할 분담: 카운트·파일 존재·Codex 프롬프트 수·frontmatter 유효성·서브에이전트 호출 무결성은 validate-plugin이 검사한다. 이 스킬은 스크립트가 검사할 수 없는 것(테이블 행, 상세 섹션 블록, 본문 교차참조, Codex 카탈로그 항목)을 담당한다.
Trigger: skill-manage, 스킬 관리, 스킬 추가, 스킬 삭제, skill-add, skill-delete, skill-rename
User: "스킬 삭제 - foo 스킬 제거해줘"
User: "skill-add - 새 스킬 bar 만들자"
User: "skill-rename - baz를 qux로 바꿔줘"예외:
docs/plans/YYYY-MM-DD-*.md는 frozen historical artifact이므로 건드리지 않는다.
RED-GREEN-REFACTOR 사이클을 강제하는 테스트 주도 개발.
핵심 원칙: 테스트가 실패하는 걸 보지 않았다면, 그 테스트가 올바른 것을 검증하는지 알 수 없다.
- RED — 실패하는 테스트 하나를 작성한다
- RED 검증 — 실행해서 실패를 확인한다 (필수, 절대 건너뛰지 않음)
- GREEN — 테스트를 통과시키는 최소한의 코드를 작성한다
- GREEN 검증 — 실행해서 통과를 확인한다 (필수)
- REFACTOR — 테스트를 GREEN으로 유지하면서 정리한다
테스트 전에 코드를 썼다면 — 삭제하고 다시 시작. 합리화 방지 테이블과 Red Flags 목록 내장.
Trigger: tdd, TDD, 테스트 먼저, test first, 테스트 주도, RED GREEN REFACTOR
User: "tdd - 이메일 검증 기능 구현해줘"
User: "테스트 먼저 - 결제 모듈 버그 수정"스킬, 하네스, AGENTS.md, CLAUDE.md, Codex 프롬프트, 메모리, 프로젝트 문서가 너무 많이 쌓여 서로 충돌하거나 과도한 탐색을 유발하는지 감사하고, 근거 기반으로 개선점을 제안하거나 안전한 범위에서 직접 정리.
하네스를 더 키우기 전에 먼저 펄프를 찾는다. 같은 상황에서 반대 행동을 요구하는 규칙, 원본과 파생본의 카운트/트리거 drift, 여러 스킬이 동시에 강하게 반응하는 라우팅 충돌, 작업 전 필수 읽기 문서가 과도한 over-read loop, 실제 셸/OS와 맞지 않는 검증 명령, 개인 메모리와 팀 문서의 경계 누수를 증거 기반으로 분류한다.
핵심 원칙은 더하기 전에 빼기, 원본 우선, 가장 좁은 권위 문서 우선, 탐색 예산 명시, 저위험 수정만 즉시 적용이다. 분석만 요청하면 보고서로 멈추고, 개선까지 요청하면 카운트·링크·카탈로그·프롬프트 수·stale 문구처럼 검증 가능한 drift를 좁게 고친다.
Trigger: find-pulp, 하네스 꼬임, 스킬 꼬임, 규칙 충돌, 지시사항 충돌, 과도한 탐색, 탐색 과잉, 컨텍스트 과잉, 하네스 감사, 스킬 감사, source-of-truth drift, 원본/배포본 드리프트, 메모리/AGENTS/스킬 동기화, 규칙이 너무 많아, 에이전트가 헤매
User: "find-pulp - 내 전역 AGENTS, 메모리, plugin-mh 스킬이 서로 꼬이는지 봐줘"
User: "하네스 꼬임 검사하고 명백한 카운트/프롬프트 drift는 고쳐줘"
User: "스킬들이 너무 많이 트리거되는 것 같은데 과도한 탐색 줄이는 방향으로 개선해줘"Tiered 리뷰로 코드 품질을 빠르게 검증.
[Fast Path]
code-reviewer ──┐
├─ APPROVE/LOW만 → 종료
└─ MEDIUM↑ 발견 → [Deep Path]
├─ architect ─┐
└─ critic ────┴─ 최종 판정
(병렬)
1차는 plugin-mh:code-reviewer 단독으로 빠르게. MEDIUM 이상이 발견될 때만 architect+critic을 병렬 소환해 깊이 본다. 재체이닝은 변경 파일 + 영향 호출처만, 최대 3 cycle.
architect / critic은 agents/architect.md, agents/critic.md를 Read해 general-purpose 프롬프트에 주입하는 페르소나다. v3까지는 미설치 외부 플러그인의 에이전트를 호출해 Deep Path가 항상 실패했다 — v4에서 제거.
Trigger: review-loop, 리뷰 루프, 리뷰 돌려, 코드 리뷰 루프, 리뷰하고 고쳐
User: "리뷰 루프 돌려"
User: "review-loop - 방금 작성한 코드 검증해줘"AI가 생성한 슬롭 코드를 회귀 안전 + 삭제 우선 + 한 종류씩 정리하는 워크플로우.
핵심 철학: 삭제 우선, 추가 신중. 새 기능을 만드는 게 아니라 이미 있는 노이즈를 정리한다.
[1] 동작 보호 (테스트 우선) → [2] 정리 계획 → [3] 슬롭 분류
→ [4] 한 종류씩 단일 패스 → [5] 품질 게이트 → [6] 증거 밀도 보고
슬롭 6분류:
| 종류 | 정의 |
|---|---|
| Duplication | 반복 로직, 복붙 분기, 중복 헬퍼 |
| Dead code | 미사용 코드, 도달 불가 분기, 디버그 잔재 |
| Needless abstraction | 패스스루 래퍼, 사변적 간접 호출, 1회용 헬퍼 |
| Boundary violations | 숨겨진 결합, 잘못된 레이어 import/사이드 이펙트 |
| Missing tests | 락되지 않은 동작, 약한 회귀 커버리지 |
| UI/design defaults | 제너릭 비주얼 패턴 (AI 블루/퍼플, 균등 그리드 등) |
단일 패스 편집: Pass 1 Dead code → Pass 2 중복 → Pass 3 네이밍/에러 → Pass 4 테스트. 무관한 리팩토링 번들링 금지.
Review Mode (--review): 편집 금지. 리뷰어 판정 + 후속 조치 항목만 작성. Writer ↔ Reviewer 분리 강제.
Trigger: ai-slop-cleaner, deslop, anti-slop, AI slop, AI 슬롭, 슬롭 정리, 쓰레기 코드 청소, 코드 슬롭
User: "deslop this module: 너무 많은 래퍼, 중복 헬퍼, 죽은 코드"
User: "/ai-slop-cleaner src/auth --review"
User: "AI 슬롭 정리 — 동작은 그대로 두고 경계만 조이기"모호한 아이디어를 4단계 파이프라인으로 심화하고 구현까지 이어간다.
핵심 철학: 갭을 체크리스트로 추적하고, 빠진 항목이 없어질 때까지 반복한다.
Phase 1: 요구사항 → Phase 2: 설계 → Phase 3: 검증 → Phase 4: 실행
(게이트) (게이트) (게이트) (Generator-Evaluator)
게이트는 체크리스트다. 각 Phase의 필수 항목이 문서에 실제로 적혀 있는지로 판정한다. 자기평가 점수(Ambiguity = 1 - Σ(score × weight))는 v2부터 게이트가 아니라 질문 타겟 선정용 보조 지표로 격하됐다 — 점수를 올려 게이트를 통과시킬 수 있었기 때문이다.
라운드 상한 (라운드당 질문 2-4개 배치)
| 프리셋 | Phase당 최소 | Phase당 최대 |
|---|---|---|
| lite | 1 | 3 |
| standard (기본) | 1 | 5 |
| deep | 2 | 8 |
상한에 닿으면 미충족 항목을 [미해결]로 명시하고 진행한다.
Phase 4 — Generator-Evaluator 루프
story 단위로 구현→검증을 반복한다. 만드는 쪽과 평가하는 쪽을 분리하고, 평가자는 확인(confirmation)이 아니라 반박(falsification)을 목표로 한다. FAIL 시 최대 3회 재시도, 이후 계속 시도 / 건너뛰기 / 지금까지 PASS한 것만 Ship / 중단을 사용자가 선택한다. 완료 후 /review-loop 체이닝.
Output: docs/ouroboros/{date}-{slug}/
01-requirements.md— 목표, 제약, 비목표, 수용기준02-design.md— ADR, 기술스펙, 다이어그램, 파일별 계획03-verification.md— E2E 시나리오, 엣지케이스, 성공/실패 기준stories.json— story별 status·검증 증거 (세션 중단 시 재개 지점)
Trigger: ouroboros, 우로보로스, 심층 문서, deep spec, 계획 실행, 문서 기반 구현, run the plan
User: "ouroboros - 사내 피드백 수집 도구 기획부터 검증까지"
User: "심층 문서 - 구독 결제 시스템 설계해줘"
User: "ouroboros --run docs/ouroboros/2026-07-30-auth/" # 계획이 이미 있으면 실행만페르소나 4종 병렬 분석 + 중복 검증 기반 세션 마무리.
Phase 1: Analysis (Parallel)
┌──────────────┬──────────────┬──────────────┬──────────────┐
│ doc-updater │ automation- │ learning- │ followup- │
│ │ scout │ extractor │ suggester │
└──────┬───────┴──────┬───────┴──────┬───────┴──────┬───────┘
└──────────────┴──────────────┴──────────────┘
│
Phase 2: Validation ▼
┌─────────────────────────────────────────────────────────────┐
│ duplicate-checker │
└─────────────────────────────────────────────────────────────┘
5개 이름은 agents/*.md의 페르소나 파일이다. Read해서 general-purpose 프롬프트에 주입한다 — v2까지는 Task(subagent_type="doc-updater")로 호출해 5개 전부 실패했다.
메모리 누적만 필요하면 /closing-lite나 plugin-mh:knowledge-curator가 더 싸다.
Trigger: /closing, /wrap, session closing
session-closing의 경량 버전 — 30초 안에 끝내는 메모리 누적 전용.
session-closing이 5개 에이전트 + 2 phase로 무겁다고 느낄 때 사용. 본질만 남겼다 — 이번 세션에서 기억할 만한 것만 골라 auto-memory에 누적. 에이전트 호출/문서 갱신/자동화 제안 모두 없음.
1. git status (한 줄)
2. 인라인 추출 (이슈 / 배운 점 / 기억할 것)
3. AskUserQuestion 1회 — 어느 항목을 메모리에 남길지
4. 선택 항목을 memory/{type}_{slug}.md + MEMORY.md에 기록
| 상황 | 적합 |
|---|---|
| 짧은 세션이지만 기억할 인사이트가 있음 | closing-lite |
| 큰 기능 완성 + 문서/자동화/커밋 종합 검토 | /closing |
Trigger: /closing-lite, /clite, 라이트 클로징, 간단 마무리, 메모만, 세션 메모
User: "/closing-lite"
User: "라이트 클로징 - 오늘 작업한 거 기억할 것만"YouTube 영상을 자막 기준으로 처리 — 슬라이드 캡쳐와 요약·퀴즈 두 모드.
| 모드 | 산출물 | 영상 다운로드 |
|---|---|---|
| slides (기본) | slides.md + slides.html + images/ (자막 구간별 프레임 캡쳐) |
필요 (720p) |
| digest | 요약 + 인사이트 + 한국어 전문 번역 + 9문항 퀴즈 (research/readings/youtube/) |
불필요 (자막만) |
| both | 위 둘 다 | 필요 |
Dependencies: yt-dlp (공통), ffmpeg + Python 3 (slides 전용)
scripts/_common.sh가 Windows 문제를 처리한다 — yt-dlp PATH 부재 시 python -m yt_dlp 폴백, --cookies <cookies.txt> (DPAPI 때문에 --cookies-from-browser는 미지원), JS 챌린지용 --remote-components ejs:github 자동 적용.
Trigger: youtube-slides, 자막 캡쳐, 영상 슬라이드, 유튜브 정리, 영상 요약, 영상 퀴즈
User: "youtube-slides https://youtube.com/watch?v=..."
User: "자막 캡쳐 - [URL]"
User: "유튜브 정리 - [URL]" # digest 모드Severity 기반 코드 리뷰 에이전트. CRITICAL / HIGH / MEDIUM / LOW 등급으로 결과를 분류하며 로직 결함, 보안, SOLID 원칙, 성능을 점검한다.
review-loop 스킬의 1차 리뷰어로도 사용된다.
User: "code-reviewer로 방금 작성한 모듈 검토해줘"지식 큐레이션 에이전트. 세션에서 재사용 가능한 학습·패턴·선호도·후속작업만 추출해 auto-memory에 누적한다. 노이즈를 걸러 영속 가치만 남기며(KEEP/DROP 게이트), 보고서 경로가 주어지면 마크다운 다이제스트도 남긴다.
호출 시 세션 맥락 + 메모리 디렉토리 경로를 인자로 전달한다(서브에이전트는 부모 대화를 보지 못하므로 필수). session-closing·closing-lite가 위임할 워커로 설계됐다.
User: "knowledge-curator로 이번 세션에서 배운 것 메모리에 정리해줘"이 플러그인에 등록된 에이전트는 2개다.
| 이름 | 용도 |
|---|---|
plugin-mh:code-reviewer |
Severity 기반 코드 리뷰 |
plugin-mh:knowledge-curator |
세션 학습·선호도를 메모리에 누적 |
Agent(subagent_type=...)에 넘길 수 있는 이름은 위 2개와 런타임 기본 에이전트(general-purpose, Explore, Plan)뿐이다.
skills/<name>/agents/*.md는 플러그인 에이전트가 아니라 페르소나 프롬프트 소스다. Read해서 general-purpose 프롬프트에 주입한다.
# 올바름
Agent(subagent_type="general-purpose",
prompt=<agents/critic.md 전문> + "
---
" + context)
# 틀림 — 등록되지 않은 에이전트라 런타임에 실패
Agent(subagent_type="critic", prompt=context)oh-my-claudecode 의존 금지. v2.0.0에서 전부 제거했다. 도구 이름은 Agent이며 Task는 구 API다.
scripts/validate-plugin.ps1이 네 가지를 검사한다 — 미등록 subagent_type, Task( 사용, OMC 의존, 삭제된 스킬로의 dangling 참조.
skills/my-skill/
├── SKILL.md # Required — defines triggers and workflow
├── references/ # Optional — supporting docs
└── agents/ # Optional — sub-agent definitions
상세 가이드는 GUIDE.md 참고.
MIT