virtual-insanity
← 리포트 목록

Claude Code 스킬 & 커맨드 카탈로그 (전면 개편)

2026-04-24 handover [handover, skills, commands, agents, catalog, onboarding]

Claude Code 스킬 & 커맨드 카탈로그

조사일: 2026-04-24
대상 경로: ~/.claude/skills, ~/.claude/commands, ~/.claude/agents
총계: 스킬 65개 (+미문서 9개), 슬래시 커맨드 12개, 커스텀 에이전트 7개
출처 보강일: 2026-04-22 (실측 기반)


§ 0. Claude Code 스킬이란?

개념

스킬(Skill)은 SKILL.md Markdown 파일 하나로 정의되는 행동 패키지다. Claude가 사용자 메시지를 보고 description 필드의 트리거 문구와 자동 매칭하면 해당 스킬의 절차를 따른다.

사용자 메시지 → Claude가 description 매칭 → SKILL.md 절차 실행

발동 방식 2가지

방식 예시 설명
자동 매칭 "볼트에 저장해줘" Claude가 description 읽고 vault-write 스킬 자동 선택
슬래시 커맨드 /ideas, /close 사용자가 직접 명령어 입력해서 수동 호출

스킬이 할 수 있는 것

  • 내부에서 Bash 명령어 실행
  • references/ 하위 문서 참조 (상세 지침, 필드 사전, 레이어 워크플로우)
  • scripts/ 하위 Python/Shell 스크립트 호출
  • 서브에이전트 병렬 실행 지시 (에이전트 분기 패턴)

저장 위치

~/.claude/skills/<skill-name>/SKILL.md        # 사용자 정의 스킬
~/.claude/commands/<command>.md               # 슬래시 커맨드 (파일 하나 = 커맨드 하나)
~/.claude/agents/<agent>.md                   # 커스텀 에이전트 정의
~/.claude/plugins/cache/<plugin>/skills/      # 플러그인 번들 스킬

슬래시 커맨드와 스킬의 차이

스킬 (SKILL.md) 슬래시 커맨드 (.md)
위치 ~/.claude/skills/ ~/.claude/commands/
발동 자동 매칭 + /명령어 /명령어 전용
용도 범용 절차 (긴 워크플로우) 빠른 루틴 (조회·리뷰·브리핑)
인자 description 트리거 $ARGUMENTS로 인자 전달 가능

§ 1. 실제 SKILL.md 예시

예시 A — 짧은 스킬: vault-query (53줄)

경로: ~/.claude/skills/vault-query/SKILL.md

---
name: vault-query
description: 볼트에 질문하고 답변을 다시 에이전트 볼트 노트로 자동 저장해야 할 때 사용한다. "볼트에 질문", "vault query", "ghost 질의 저장", "company-research 결과 저장", "Defileo/Karpathy 패턴", "질의 결과를 노트로 남겨" 같은 요청에 반응한다.
---

# Vault Query

볼트 검색 → 답변 생성 → `~/knowledge-agent/200-atomic/`에 원자 노트 저장 → `vault_ingest_linker` 연결까지 한 번에 수행한다.

## 원칙

- `~/knowledge/`는 읽기 전용. 답변 노트는 반드시 `~/knowledge-agent/200-atomic/`에 저장한다.
- 질문에 답할 때는 먼저 볼트 검색 결과를 근거로 삼고, 미확인 추론은 표시한다.
- 저장 노트 frontmatter:

```yaml
---
title: "질문 기반 제목"
date: YYYY-MM-DD
source: vault-query
tags: [query, 질문키워드]
---

실행 절차

  1. 질문 키워드 2~5개 추출.
  2. ~/knowledge/~/knowledge-agent/에서 관련 노트 검색.
  3. 빠른 기본 검색: rg -n "키워드1|키워드2" ~/knowledge ~/knowledge-agent --glob '*.md'
  4. 필요하면 기존 /ghost, company-research, vault search 도구를 사용.
  5. 검색 근거로 짧게 답변 작성.
  6. 아래 저장 스크립트로 답변을 200-atomic에 저장.
python3 ~/.claude/skills/vault-query/scripts/save_vault_query_note.py \
  --title "제목" \
  --question "해리 질문" \
  --tags "키워드1,키워드2" \
  --evidence "관련 노트 경로 또는 요약" \
  --answer-file /tmp/answer.md
  1. 스크립트가 저장된 노트를 vault_ingest_linker.py에 전달해 기존 노트와 연결한다.
  2. 최종 보고에는 답변 요지와 저장 경로만 짧게 포함한다.

저장 스크립트

  • 경로: scripts/save_vault_query_note.py
  • 기본 저장 위치: ~/knowledge-agent/200-atomic/
  • 기본 동작: 저장 후 linker 실행
  • linker를 끄려면 --no-linker
  • 쓰기 없이 확인하려면 --dry-run

**포인트**: description에 트리거 예시를 나열. scripts/ 디렉토리의 Python 스크립트를 직접 호출.

---

### 예시 B — 중간 복잡도 스킬: infra-ops (50줄, references/ 참조)

경로: `~/.claude/skills/infra-ops/SKILL.md`

```markdown
---
name: infra-ops
description: OpenClaw 인프라·시스템 운영 작업을 수행한다. "워커 확인해줘", "시스템 상태 봐줘", "게이트웨이 체크", "서비스 재시작해줘", "ops 점검", "인프라 상태" 같은 말에 클로드가 자동으로 이 스킬을 사용한다.
---

# Infra Ops

OpenClaw 시스템 인프라 운영 스킬.

## 주요 경로

- 설정: `~/.openclaw/.env`, `~/.openclaw/config/`
- 워커: `~/.openclaw/workspace/`
- 크론 잡: `~/.openclaw/cron/jobs.json`
- 로그: `~/.openclaw/logs/`
- DB: `~/.openclaw/data/ops_multiagent.db`
- LaunchAgent: `~/Library/LaunchAgents/`

## 시스템 상태 확인

```bash
# OpenClaw 워커 상태
ps aux | grep -E "openclaw|worker|antfarm" | grep -v grep

# 텔레그램 봇 상태
ps aux | grep -E "telegram|haryboi|ronclaw" | grep -v grep

# LaunchAgent 상태
launchctl list | grep -i openclaw

워커 재시작

워커 코드 수정 후 반드시 전체 재시작:

launchctl stop <service-name>
launchctl start <service-name>

알려진 함정

  • 타임아웃 설정: .envOPENCLAW_PER_MODEL_TIMEOUT_SEC (현재 300초)
  • 텔레그램 409 충돌: 같은 봇 토큰으로 두 인스턴스 실행 금지
  • DB는 WAL 모드 — 동시 쓰기 시 트랜잭션 잠금 확인
  • .env.profile 타임아웃 값 동기화 유지

참고

운영 인프라 상세 → references/infra-map.md


**포인트**: 마지막 줄 `references/infra-map.md` — 스킬 디렉토리 안 references/ 폴더의 상세 문서를 참조하는 패턴. 스킬 본문은 짧게 유지하고 상세는 외부 참조.

---

## § 2. 커스텀 에이전트 (~/.claude/agents/) 포맷

커스텀 에이전트는 Claude Code가 특정 역할 모드로 동작할 때 참조하는 정의 파일. frontmatter의 `name`·`description`으로 자동 매칭된다.

### 예시 A — codex-bridge.md (실제 파일)

```markdown
---
name: codex-bridge
description: Use when deciding whether a task should go to Codex (GPT-5.3) or be handled by Claude Code, when delegating code development or MCP tool creation tasks to Codex via the agent queue, or when coordinating work that spans both Claude Code and Codex to avoid duplication.
---

# Codex Bridge

## Role

Claude Code와 Codex(GPT-5.3) 간 작업 분담을 조율하는 에이전트.

## 역할 분담 기준

### Codex가 해야 하는 것
- 새 파이프라인 Python 스크립트 작성
- MCP 도구 신규 개발 및 테스트
- 버그 수정 (명확한 에러 → 명확한 픽스)
- 장시간 독립 실행 가능한 코드 작업

### Claude Code가 해야 하는 것
- 아키텍처·설계 결정
- 볼트 분석·리서치 작업
- 해리와의 실시간 대화형 작업
- 훅/스킬/CLAUDE.md 변경 (시스템 정책)

## Codex에 위임하는 방법

`~/.openclaw/workspace/bus/messages.jsonl`에 메시지 작성:
```json
{
  "ts": "ISO8601",
  "from": "claude-code",
  "to": "codex",
  "type": "task",
  "body": "작업 내용 (구체적으로)"
}

작업 전달 템플릿

[Codex에게]
작업: {구체적 요청}
파일: {대상 파일 경로}
컨텍스트: {필요한 배경}
완료 기준: {어떻게 됐을 때 완료인지}
검증 방법: {테스트 또는 확인 방법}

하네스 원칙

  1. Evaluator 분리: 출력 생성(Generator) 후 별도 Evaluator가 채점. 3.5/5 미달 시 재생성.
  2. 위키 축적: 작업 결과·패턴을 ~/knowledge-agent/200-atomic/patterns/에 기록.

### 예시 B — sector-analyst.md 구조 요약

```markdown
---
name: sector-analyst
description: Use when analyzing industry cycles, value chains, sector supply/demand dynamics...
---

# Sector Analyst

## Role          # 한 줄 역할 정의
## 전문 영역     # 구체적 분석 기법 목록
## 참조 볼트 경로 # 관련 볼트 폴더 경로
## 사용 가능한 스킬 # 연계 스킬명
## 작동 방식     # 1~4 단계 절차
## 출력 형식     # 결과물 표 형태
## 주의          # 하지 말아야 할 것
## 하네스 원칙   # Evaluator 분리 + 위키 축적 (공통 규칙)

에이전트 vs 스킬 차이: - 스킬: 특정 작업 절차 실행 (verb — 무언가를 한다) - 에이전트: 특정 역할의 사고 방식과 전문성 정의 (persona — 어떤 관점으로 본다)


§ 2-b. 플러그인 ↔ 스킬 매핑 (실측)

실측 경로: ~/.claude/plugins/cache/ 디렉터리 구조 + 각 package.json / plugin.json 직접 확인 (2026-04-22)

플러그인 소유자/버전 설치 방법 제공 스킬 수 대표 스킬 GitHub
superpowers claude-plugins-official / v5.0.7 claude plugin install superpowers 14개 brainstorming, writing-plans, executing-plans, systematic-debugging, verification-before-completion, dispatching-parallel-agents 출처 불명 (package.json에 repo 없음)
claude-mem thedotmack / v10.6.2 claude plugin install claude-mem 5개 do, make-plan, mem-search, smart-explore, timeline-report https://github.com/thedotmack/claude-mem
telegram claude-plugins-official / v0.0.6 claude plugin install telegram 2개 access, configure 출처 불명 (공식 플러그인 스토어)
code-review-graph tirth8205 / v1.8.3 claude plugin install code-review-graph 3개 build-graph, review-delta, review-pr https://github.com/tirth8205/code-review-graph
everything-claude-code affaan-m / v1.9.0 claude plugin install everything-claude-code 100개+ 범용 엔지니어링 스킬 묶음 (현재 해리 미활성 — 카탈로그 미포함) https://github.com/affaan-m/everything-claude-code
figma claude-plugins-official / v2.1.7 claude plugin install figma 미확인 Figma 디자인 연동 (현재 해리 미활성) 출처 불명 (공식)
local (~/.claude/skills/) 해리 커스텀 N/A — 파일 복사만 65개+ company-research, infra-ops, vault-write, vault-query, error-resolve N/A
local (~/.claude/commands/) 해리 커스텀 N/A — 파일 복사만 12개 /today, /ideas, /ghost, /close, /context N/A
local (~/.claude/agents/) 해리 커스텀 N/A — 파일 복사만 7개 codex-bridge, sector-analyst, company-analyst N/A

참고: vibesubin 계열 12개 스킬은 로컬 커스텀 파일로 존재하나, SKILL.md 내부에 Source: https://github.com/subinium/vibesubin by subinium, MIT License 명시. 플러그인 캐시에는 없음 — 해리가 수동으로 설치한 서드파티 스킬.


§ 3. 신규 환경에서 동일 스킬 세팅하는 방법

플러그인 설치 (공식/서드파티)

# 공식 플러그인 (claude-plugins-official)
claude plugin install superpowers
claude plugin install telegram
claude plugin install figma

# 서드파티 플러그인 (GitHub URL 또는 이름)
claude plugin install claude-mem           # thedotmack/claude-mem
claude plugin install code-review-graph   # tirth8205/code-review-graph
claude plugin install everything-claude-code  # affaan-m (선택적)

vibesubin 스킬 설치 (서드파티 수동)

# vibesubin 12개 스킬은 플러그인 캐시 없이 ~/.claude/skills/ 에 직접 복사된 파일
# 원본 소스: https://github.com/subinium/vibesubin (MIT License)
# 설치: 해당 repo에서 skills/ 디렉토리 파일을 ~/.claude/skills/ 에 복사

로컬 커스텀 이관 (해리 고유 스킬)

# 1. 해리 맥북에서 압축
tar -czf claude-custom-bundle.tar.gz \
  ~/.claude/skills/ \
  ~/.claude/commands/ \
  ~/.claude/agents/ \
  ~/.claude/CLAUDE.md

# 2. 새 환경에서 압축 해제
tar -xzf claude-custom-bundle.tar.gz -C ~/

# 3. Claude Code 재시작 (세션 새로 열기)
# 스킬은 재시작 시 자동 로드됨

이관 체크리스트

  • [ ] claude plugin install superpowers 완료
  • [ ] claude plugin install claude-mem 완료
  • [ ] claude plugin install telegram 완료
  • [ ] claude plugin install code-review-graph 완료
  • [ ] ~/.claude/skills/ 65개 복사 완료
  • [ ] ~/.claude/commands/ 12개 복사 완료
  • [ ] ~/.claude/agents/ 7개 복사 완료
  • [ ] ~/.claude/CLAUDE.md 복사 완료
  • [ ] ~/.openclaw/ 시스템 별도 이관 (infra-ops 의존)

§ 4. 서브에이전트 배분 예시

메인 Claude Code 세션에서 독립 작업 2개+ 이상일 때 병렬 서브에이전트로 분기.

기본 패턴 (Python dict 형식)

# Agent tool 호출 형식
{
    "description": "조선업 수급 데이터 수집 에이전트",
    "subagent_type": "general-purpose",
    "model": "claude-haiku-4-5",          # 탐색·검색 = haiku
    # "model": "claude-sonnet-4-6",       # 일반 구현 = sonnet
    # "model": "claude-opus-4-5",         # 정밀분석·설계 = opus
    "prompt": """
너는 수급 데이터 수집 에이전트.
작업: ~/knowledge-agent/100-inbox/에서 최근 7일 조선 수급 노트 전부 읽고
결과를 /tmp/shipbuilding_flow.json에 저장해라.
완료 후 저장 경로와 파일 라인수만 보고.
""",
    "run_in_background": True             # 병렬 실행
}

실제 사용 패턴 — company-research 내부 4-에이전트 병렬

# company-research 스킬이 첫 동작으로 4개 병렬 실행하는 구조:

에이전트_1 = {
    "description": "볼트 탐색",
    "model": "haiku",
    "prompt": "~/knowledge/ 에서 {기업명} 관련 기존 노트 전부 찾아 경로 목록 반환"
}

에이전트_2 = {
    "description": "DART 공시 수집",
    "model": "sonnet",
    "prompt": "DART MCP로 {기업명} 최근 1년 공시 수집. 사업보고서 우선"
}

에이전트_3 = {
    "description": "재무 데이터 수집",
    "model": "sonnet",
    "prompt": "yfinance로 {티커} 최근 4분기 재무제표 수집. JSON 저장"
}

에이전트_4 = {
    "description": "뉴스·심리 수집",
    "model": "haiku",
    "prompt": "WebSearch로 {기업명} 최근 30일 뉴스 + twitter-reader로 fintwit 심리 수집"
}

# 4개 동시 실행 → 완료 후 메인이 결과 통합 → 8-Layer 분석 시작

모델 선택 가이드

작업 유형 모델 이유
볼트 검색, 키워드 매칭 haiku 빠르고 저렴, 단순 탐색 충분
일반 구현, 스크립트 작성 sonnet 균형잡힌 성능
복잡한 설계, 다단계 판단 opus 정밀 분석 필요 시

cmux 오케스트레이션

tmux 멀티 세션 기반 병렬 실행은 cmux-orchestrator 스킬 참조.
상세 → ~/.claude/skills/cmux-orchestrator/SKILL.md 및 ecosystem.md


§ 5. 스킬 신규 작성 템플릿

SKILL.md 기본 구조

---
name: my-new-skill
description: "<이 스킬을 발동할 트리거 문구 예시들. 사용자가 말할 법한 표현을 여러 개 나열한다. Claude가 이 description을 읽고 자동 매칭하므로 구체적일수록 좋다.>"
---

# My New Skill

한 줄 요약 — 이 스킬이 무엇을 하는지.

## 원칙

- 핵심 제약 사항
- 읽기 전용 여부, 저장 위치 등

## 실행 절차

1. 첫 번째 단계
2. 두 번째 단계
3. ...

## 참고

상세 문서 → `references/detail.md`

디렉토리 구조

~/.claude/skills/my-new-skill/
├── SKILL.md              # 메인 (필수)
├── references/           # 선택 — 상세 지침, 데이터 사전
│   └── detail.md
└── scripts/              # 선택 — Python/Shell 실행 스크립트
    └── run.py

description 작성 요령

# 좋은 예
description: "볼트에 저장해줘", "노트 만들어줘", "기록해줘", "vault write",
             "인사이트 저장", "분석 결과 저장" 같은 요청에 반응한다.

# 나쁜 예
description: Saves notes to vault.
  • 실제 사용자가 말할 법한 한국어 표현 우선
  • 여러 표현 변형을 쉼표로 나열
  • 마지막에 "~에 반응한다" 또는 "~할 때 사용한다" 로 마무리

하네스 원칙 (공통 — 모든 스킬에 추가 권장)

## 하네스 원칙
1. **Evaluator 분리**: 출력 생성(Generator) 후 별도 Evaluator가 채점. 3.5/5 미달 시 재생성.
2. **위키 축적**: 작업 결과·패턴을 ~/knowledge-agent/200-atomic/patterns/에 기록.

§ 6. 카테고리별 스킬 카탈로그 (65개) — 출처 포함

출처 범례
local custom = ~/.claude/skills/ 직접 파일, 이관 시 파일 복사만 필요
vibesubin (서드파티) = https://github.com/subinium/vibesubin 수동 설치
plugin: superpowers = claude-plugins-official/superpowers v5.0.7 번들
plugin: claude-mem = thedotmack/claude-mem v10.6.2 번들
plugin: telegram = claude-plugins-official/telegram v0.0.6 번들
plugin: code-review-graph = tirth8205/code-review-graph v1.8.3 번들


6.1 투자분석 (금융) — 16개

스킬 트리거 용도 출처
company-research "조선업 봐줘", "삼성전자 분석해줘", 산업/기업명 + 분석 볼트 기반 통합 리서치. 8-Layer 프레임워크 (추정·밸류시각화·수급·내러티브·촉매·엣지·홀딩규칙·모니터링) 순 실행 local custom
valuation "DCF 돌려줘", "적정가치 구해줘", "WACC 계산해줘" DCF, DDM, EV/EBITDA, P/S, SOTP 등 정량 밸류에이션 모델 실행 local custom
equities 주식 비율·팩터 분석, 인덱스 구성 방식 질문 주식 증권 분석, 팩터 모델, 스타일 분석, 지수 구성 방법론 local custom
fixed-income 국채·회사채·수익률곡선·듀레이션·컨벡시티 질문 채권 분석 (국채·크레딧), 듀레이션/컨벡시티, TIPS, 스프레드 local custom
alternatives 헤지펀드·PE·VC·2and20·IRR·J-curve 언급 시 대체투자 전략 분류, 성과 지표 (IRR/TVPI/DPI), 실사 프레임워크 local custom
risk-analysis "VaR 구해줘", "최대낙폭 분석", "리스크 측정" 역사적·모델 기반 리스크 정량화 (VaR, 드로다운, GARCH) local custom
volatility-modeling EWMA·GARCH·내재변동성·변동성 서피스 질문 변동성 예측 모델 실행, 옵션 내재변동성 분석 local custom
options-payoff 콜·풋·스트래들·아이언콘도르 등 옵션 전략 언급 시 옵션 페이오프 다이어그램 생성, 멀티레그 전략 분석 local custom
asset-allocation "포트폴리오 배분", "자산배분 추천", "MVO 돌려줘" 전략적·전술적 자산배분, 평균분산최적화, Black-Litterman local custom
bet-sizing "포지션 크기", "켈리 계산", "리스크 예산" 포지션 사이징 (Kelly criterion, fractional Kelly, 리스크 버짓) local custom
diversification "상관관계 분산", "효율적 프론티어", "포트폴리오 분산" 상관관계 기반 분산, 효율적 프론티어 구성, 팩터 분산 local custom
stock-correlation "AAPL과 MSFT 상관관계", "페어 트레이딩" 종목 간 상관관계 분석, 섹터 피어 그룹, 페어 트레이딩 탐색 local custom
performance-metrics "샤프 비율", "소르티노", "정보비율", "업사이드 캡처" 위험조정 성과 지표 계산 (Sharpe/Sortino/IR/Treynor) local custom
performance-attribution "수익 분해", "Brinson 어트리뷰션", "알파 출처" 포트폴리오 수익 구성요소 분해 (배분·선택·상호작용 효과) local custom
return-calculations "TWR 계산", "MWR/IRR", "연환산 수익률" 투자 수익률 계산·비교 (TWR/MWR/CAGR/연환산) local custom
statistics-fundamentals 수익률 분포, 공분산 추정, 회귀, 가설 검정 질문 금융 데이터에 통계 기법 적용 (기술통계, 회귀, 리샘플링) local custom

6.2 시스템 운영 (OpenClaw) — 7개

스킬 트리거 용도 출처
infra-ops "워커 확인해줘", "게이트웨이 체크", "서비스 재시작", "인프라 상태" OpenClaw 인프라·시스템 운영. 게이트웨이·워커·DB 상태 점검 및 조치 local custom
error-resolve "왜 안 돌아", "에러났어", "크론이 실행 안 돼", "장애났어" OpenClaw 에러·장애·크론 문제 진단 및 수정 local custom
pipeline-create "새 파이프라인 만들어줘", "크론 잡 추가해줘", "자동화 만들어줘" OpenClaw에 새 파이프라인 스크립트·자동화 추가 local custom
pipeline-debug "파이프라인이 안 돌아", "스크립트 에러났어", "왜 실패했어" 파이프라인 실행 오류 진단 (읽기 전용) local custom
cmux-orchestrator "cmux에 배분", "팀 가동", "orchestrate 세션", "cmux dispatch" cmux 7-surface 팀 자동 오케스트레이션. 배분→감시→수집→저장 자동화 local custom
skill-creator "스킬 만들어줘", "새 스킬 추가해줘", "이걸 스킬로 만들어줘" 새 Claude Code 스킬 설계 및 생성 local custom
skill-improve "/close 자동 발동", "스킬 개선해줘", "스킬 문제 찾아줘" 스킬 실행 기록 분석 → 개선 필요 스킬 탐지 및 수정안 제안 local custom

6.3 볼트 관리 — 2개

스킬 트리거 용도 출처
vault-query "볼트에 질문", "vault query", "질의 결과를 노트로 남겨" 볼트 질문 후 답변을 에이전트 볼트 노트로 자동 저장 local custom
vault-write "볼트에 저장해줘", "노트 만들어줘", "기록해줘" ~/knowledge-agent/ 에 노트·인사이트·분석 결과 저장. ~/knowledge/ 는 읽기 전용 local custom

6.4 코드 품질 (vibesubin 계열) — 12개

모두 https://github.com/subinium/vibesubin (서드파티, MIT License) 수동 설치. 플러그인 캐시 없음. 이관 시 파일 복사 또는 원본 repo에서 재설치.

스킬 용도 출처
vibesubin 저장소 전체 코드 위생 전문 스킬 병렬 실행 후 우선순위 보고서 생성. /vibesubin 명령 vibesubin (서드파티)
vibesubin-audit-security 보안 스윕 — 커밋된 시크릿, SQL/셸 인젝션, XSS, 경로 순회, 위험 역직렬화 탐지 vibesubin (서드파티)
vibesubin-codex-fix Codex 2차 리뷰 → refactor-verify 핸드오프 루프 vibesubin (서드파티)
vibesubin-fight-repo-rot 저장소 부패 탐지 — 데드코드, 갓파일, 핫스팟, 하드코딩 경로, 오래된 TODO vibesubin (서드파티)
vibesubin-manage-assets 과대 파일·바이너리 bloat·git 히스토리 숨겨진 대형 blob 탐지 vibesubin (서드파티)
vibesubin-manage-secrets-env 시크릿·환경변수 전체 생애주기 관리 (.env, CI secret, .env.example 스캐폴딩) vibesubin (서드파티)
vibesubin-project-conventions 브랜치 전략·디렉토리 레이아웃·의존성 고정·경로 이식성 컨벤션 설정 vibesubin (서드파티)
vibesubin-refactor-verify 동작 보존 코드 변경(리팩터) 완전성 증명 — 의존성 트리 기반 실행 vibesubin (서드파티)
vibesubin-setup-ci CI/CD 원리 설명 후 테스트+배포 파이프라인 스캐폴딩 (GitHub Actions 등) vibesubin (서드파티)
vibesubin-ship-cycle 이슈 기반 개발 오케스트레이터. 이슈→마일스톤→semver→PR 전 사이클 vibesubin (서드파티)
vibesubin-unify-design 웹 프로젝트 디자인 시스템 단일 소스화. 하드코딩 hex·spacing 드리프트 감사 vibesubin (서드파티)
vibesubin-write-for-ai AI 다음 세션을 위한 README·CLAUDE.md·커밋 메시지·PR 설명 작성 vibesubin (서드파티)

6.5 외부 데이터 & 소셜 — 8개

스킬 트리거 용도 출처
twitter-reader "트위터에서 뭐래", "fintwit", "@user 팔로워", "AAPL 시장 심리" Twitter/X에서 금융 리서치용 데이터 읽기 local custom
twitter-apply x.com/ 또는 twitter.com/ 링크, "이 트윗 적용" 트위터 링크 받으면 내용 분석 후 시스템 적용 판단 local custom
telegram-reader "텔레그램 채널 뭐 있어", "crypto Telegram", "시장 뉴스 텔레그램" 텔레그램 채널·그룹 메시지 읽기 (금융 리서치 목적) local custom
discord-reader "트레이딩 Discord 뭐래", "Discord 채널 목록", "BTC 심리" Discord 서버 메시지 읽기 (금융 리서치 목적) local custom
toss-securities 토스증권 계좌·포트폴리오·시세·주문내역 조회 요청 tossctl CLI로 토스증권 계좌·포트폴리오 read-only 조회 local custom
yfinance-data "재무제표 가져와", "주가 데이터", "옵션 체인", "배당 이력" yfinance로 주가·재무·옵션·배당 데이터 수집 local custom
get-api-docs "이 라이브러리 사용법", "API 문서 확인", "최신 버전 사용법" 라이브러리·API 최신 공식 문서 수집 (context7 MCP 우선) local custom
coupang-product-search 쿠팡 상품 검색, 로켓배송 필터, 가격 비교 요청 coupang-mcp로 쿠팡 상품 검색·비교·골드박스 조회 local custom

6.6 생활 편의 — 9개

스킬 트리거 용도 출처
delivery-tracking 송장번호 + 배송 조회 요청 CJ대한통운·우체국 택배 추적 local custom
fine-dust-location 지역명 + 미세먼지 조회 요청 에어코리아 기반 미세먼지·초미세먼지 지역별 조회 local custom
kakaotalk-mac 카카오톡 채팅 읽기, 메시지 검색, 답장 요청 macOS kakaocli로 카카오톡 읽기·검색·답장 (명시적 확인 후) local custom
korean-law-search 한국 법률·판례 검색 요청 korean-law-mcp 우선, 법망 fallback으로 한국 법률 조회 local custom
hormuz-strait "오일 초크포인트", "페르시아만 유조선", "전쟁 위험 프리미엄" 호르무즈 해협 현황 및 에너지 공급망 리스크 분석 local custom
hwp HWP 파일 변환 요청 HWP 파일을 JSON·Markdown·HTML로 변환, 이미지 추출 local custom
simon-writing "김서준", "simon-writing", "해시드 스타일", "/simon" 김서준(해시드 대표) 스타일 에세이·글 생성 local custom
slides 프레젠테이션·슬라이드 제작 요청 Chart.js·디자인 토큰 기반 전략 HTML 프레젠테이션 생성 local custom
graphify /graphify 파일(코드·문서·논문·이미지) → 지식 그래프 → 커뮤니티 탐지 → HTML+JSON+감사 보고서 local custom

6.7 전문 리스크 — 3개

스킬 트리거 용도 출처
counterparty-risk OTC 거래 상대방 노출, CCR 측정, CSA·담보 관리 질문 거래상대방 신용 리스크 측정·관리 가이드 (OTC·증권거래) local custom
operational-risk 거래 오류 탐지·수정, 거래 브레이크, 운영 리스크 설계 운영 리스크 식별·측정·관리 가이드 (트레이딩·브로커리지) local custom
time-value-of-money PV/FV/NPV/IRR/연금 계산, 현금흐름 할인 요청 현재가치·미래가치·NPV·IRR·대출상환 계산 local custom

6.8 미문서 스킬 (실측 발견 — 카탈로그 미포함분) — 9개

~/.claude/skills/ 실측 결과 원본 문서에 없던 스킬 발견. 이관 시 이 파일도 복사 필요.

스킬 디렉터리 출처
blue-ribbon-nearby local custom
daiso-product-search local custom
k-skill-setup local custom
kakao-bar-nearby local custom
kbo-results local custom
kleague-results local custom
ktx-booking local custom
lotto-results local custom
seoul-subway-arrival local custom
srt-booking local custom
used-car-price-search local custom
zipcode-search local custom

§ 7. 슬래시 커맨드 (12개)

경로: ~/.claude/commands/
출처: 전량 local custom (파일 복사 이관)

명령 용도 출처
⭐ /today 오늘 브리핑 & 계획. 인텔리전스 브리프·할일·최근 노트·시그널 통합 표시 local custom
⭐ /ideas 최근 30일 노트·인사이트·가설 교차분석 → 투자 아이디어·탐구 질문·의외의 연결 생성 local custom
⭐ /close 하루 마감 리뷰. 수정 노트·완료 할일·오늘 인사이트·세션 학습 요약·단기 기억 저장 local custom
/context 볼트 전체 컨텍스트 로딩. 통계·최근 작업·할일·인사이트·지식 흐름 건강도 local custom
/ghost $TOPIC 볼트 축적 관점으로 질문 답변. 근거 노트 명시, 없으면 "탐구 미완" 표시 local custom
/challenge $THESIS 신념·가설 스트레스 테스트. 볼트 근거 + 반론 + 확인 편향 검토 local custom
/connect $A $B 도메인 간 숨겨진 연결 발굴. 교차 노트·간접 연결·다리 노트 탐색 local custom
/trace $TOPIC 특정 주제의 볼트 내 시간 순 진화 추적. 관점 변화·전환점·열린 질문 local custom
/emerge 볼트에 명시되지 않은 암시적 아이디어 발굴. 빈 공간·미완의 사고 탐색 local custom
/drift 목표 vs 실제 활동 괴리 분석. 30일 폴더별 노트 분포 vs 명시 목표 비교 local custom
/quality 6단계 품질 프로토콜 활성화 (이해→계획→사전부검→실행→검증→전달) local custom
/system OpenClaw·Claude Code·Obsidian 3개 시스템 통합 상태 한눈에 표시 local custom

§ 8. 커스텀 에이전트 (7개)

경로: ~/.claude/agents/
출처: 전량 local custom (파일 복사 이관)

에이전트 역할 트리거 조건 출처
codex-bridge Claude Code ↔ Codex(GPT-5.3) 작업 분담 조율. 중복 없이 강점 기반 라우팅 Codex vs Claude Code 선택이 필요할 때 local custom
company-analyst 기업 펀더멘탈·밸류에이션 심층 분석 전문. IRON RULE 6단계 프레임 적용 특정 기업 재무·어닝콜·피어 비교 시 local custom
cowork-coordinator Claude Code(대화형) ↔ Cowork(백그라운드 Opus) 작업 분담·인수인계 조율 Cowork 큐 적체·하룻밤 작업 검토 시 local custom
macro-analyst 금리·환율·유동성 사이클 분석. 거시 맥락 제공 금리·수익률곡선·연준 정책 분석 시 local custom
pipeline-supervisor 150개+ 파이프라인 전체 감독. 연쇄 실패 탐지·체인 흐름 관찰 파이프라인 전체 건강도 점검 시 local custom
risk-analyst 투자 테제 스트레스 테스트·하방 시나리오 정량화. "악마의 변호인" 역할 테제 검증·포트폴리오 리스크 평가 시 local custom
sector-analyst 산업 사이클·밸류체인·헤게모니 4국면 분석. 수혜 기업 선별 섹터 사이클·밸류체인 매핑 시 local custom

§ 9. 플러그인 (installed) — 출처 확정

실측 경로: ~/.claude/plugins/cache/ (2026-04-22 확인)

플러그인 버전 포함 스킬 GitHub / 설치 비고
superpowers v5.0.7 brainstorming, writing-plans, executing-plans, systematic-debugging, verification-before-completion, dispatching-parallel-agents, subagent-driven-development, test-driven-development, using-git-worktrees, finishing-a-development-branch, receiving-code-review, requesting-code-review, writing-skills, using-superpowers (14개) claude plugin install superpowers package.json에 repo URL 없음. 공식 플러그인 스토어 배포
claude-mem v10.6.2 do, make-plan, mem-search, smart-explore, timeline-report (5개) https://github.com/thedotmack/claude-mem tree-sitter 기반 코드 메모리
telegram v0.0.6 access, configure (2개) claude plugin install telegram claude-plugins-official 배포
code-review-graph v1.8.3 build-graph, review-delta, review-pr (3개) https://github.com/tirth8205/code-review-graph tirth8205 개발
everything-claude-code v1.9.0 100개+ (현재 미활성) https://github.com/affaan-m/everything-claude-code 해리 환경에 캐시만 존재, 미사용
figma v2.1.7 미확인 (현재 미활성) claude plugin install figma claude-plugins-official 배포, 미사용

주의: superpowers 14개 스킬은 plugin: 접두사로 시스템 프롬프트에 자동 로드. SKILL.md 파일 없음. 플러그인 재설치하면 복원됨.


§ 10. 해리가 자주 쓰는 스킬 Top 10 ⭐

해리 프로필 기준 (비개발자, 투자자, 조선·반도체 관심, 시스템 운영):

순위 스킬/커맨드 왜 자주 쓰이는가
1 company-research 기업·산업 분석 메인 스킬. 가장 많이 쓰이는 핵심. 8-Layer 프레임 자동 실행
2 infra-ops OpenClaw 150개+ 크론·워커 상태 점검. 시스템 이상 시 첫 번째 호출
3 error-resolve 크론 실패·파이프라인 장애·에러 진단. 운영 중 가장 자주 터지는 문제 대응
4 vault-write 분석 결과·인사이트를 ~/knowledge-agent/에 저장. 대화 후 기록 루틴
5 vault-query 볼트에 쌓인 기존 지식 검색 후 노트 저장. "예전에 뭐라고 했더라" 질문 처리
6 /today 매일 아침 브리핑 + 할일 + 시그널 통합. 하루 시작 루틴
7 /ideas 30일 볼트 교차분석 → 투자 아이디어 발굴. 주간 리뷰 시 사용
8 /close 하루 마감 + 세션 학습 저장 + 단기 기억 정리. 저녁 루틴
9 twitter-reader 조선·반도체 관련 fintwit 심리 + 시장 동향 수집
10 pipeline-debug 크론 잡 실패 원인 추적. error-resolve와 짝으로 사용

§ 11. 참고: 주요 경로 구조

~/.claude/
├── skills/          # 65개+ 개별 SKILL.md (실측: 77개 디렉터리)
├── commands/        # 12개 슬래시 커맨드 (.md)
├── agents/          # 7개 커스텀 에이전트 정의
├── plugins/
│   └── cache/
│       ├── claude-plugins-official/
│       │   ├── superpowers/5.0.7/   # 14개 스킬 번들
│       │   ├── telegram/0.0.6/      # 2개 스킬 번들
│       │   └── figma/2.1.7/         # 미활성
│       ├── thedotmack/
│       │   └── claude-mem/10.6.2/   # 5개 스킬 번들
│       ├── code-review-graph/
│       │   └── code-review-graph/1.8.3/  # 3개 스킬 번들
│       └── everything-claude-code/
│           └── everything-claude-code/1.9.0/  # 미활성
├── CLAUDE.md        # 최상위 규칙 문서
└── active-work.json # 중복 작업 방지 추적기

볼트 구조: - ~/knowledge/ — 해리 전용 (AI 읽기만 가능) - ~/knowledge-agent/ — AI 작업 공간 (자유 쓰기) - 100-inbox: Hermes → Claude Code 수신함 - 200-atomic: 원자 노트 저장소 - 300-connected: 연결 노트 - 400-reports: 에이전트 리포트 - 500-signals: 시그널 데이터 - _staging: 해리 검토 후 ~/knowledge/ 승격 대기