핵심 요약
- Skills ≠ MCP: Skills는 절차적 기억(SOP), MCP는 라이브 도구의 '손'. 상호 보완, 대체 불가.
- P0 제로 설치: bundled
/code-review,/debug,/loop,/run,/verify는 매 세션 포함 — 많은 이가 한 번도 쓰지 않음. - P1 공식 필수:
skill-creator(자작) + Document Skills(PDF/DOCX/XLSX 실파일 처리). - P2 워크플로 3종:
grill-me(착수 전 정렬),handoff(세션/Agent 인계),superpowers(다단계 TDD 오케스트레이션). - 두 유형: Capability Uplift(새 능력) vs Encoded Preference(팀 방식 고정) — 유형을 틀리면 낭비.
- 24/7 장기 실행: Skills와
~/.claude/skills/는 항상 켜진 호스트 필요. 말미 Cloud Mac 절차 참고.
1. 왜 CLAUDE.md 쌓기보다 Skills가 가치 있는가
팀 규약을 CLAUDE.md에 몰아넣으면 매 세션 수천 token을 태우고 Claude가 순서를 건너뛸 수 있습니다. Skills의 강점은 점진적 공개: 시작 시 각 스킬의 name·description(약 100 token/스킬)만 읽고, 작업 일치 시 SKILL.md 전문 로드. 무관 스킬은 컨텍스트를 차지하지 않음 — 2026 Agent 엔지니어링 기본.
공식 문서는 Skills를 Agent Skills 개방 표준 디렉터리로 정의. Claude Code는 동적 컨텍스트 주입(!`git diff HEAD`), context: fork, disable-model-invocation 등 확장. 동일 SKILL.md를 Cursor·Codex CLI·Copilot이 읽음 — 분수령은 모델 IQ가 아니라 라우팅 가능한 워크플로.
Claude Code를 상시 호스트로 옮긴다면 먼저 왜 더 많은 팀이 Cloud Mac에서 Claude Code를 돌리는가를 읽으세요. 본문은 로컬 또는 원격 Mac에서 claude CLI가 동작한다고 가정합니다.
모델 능력이 분수령이 아니다 — 라우팅 가능한 워크플로 진입점이 분수령이다.
2. 4계층: bundled / 공식 플러그인 / 프로젝트 / 커뮤니티
설치 전 출처를 구분하세요 — 신뢰 수준과 업데이트 경로가 완전히 다릅니다:
| 계층 | 경로 | 범위 | 예시 |
|---|---|---|---|
| Bundled(내장) | Claude Code 동봉 | 매 세션 기본 사용 | /code-review、/debug、/loop、/run、/verify |
| 공식 Plugin | /plugin marketplace add 또는 claude.com/plugins |
개인 또는 조직 | skill-creator、Document Skills、claude-api |
| 프로젝트급 | .claude/skills/ 또는 monorepo 중첩 |
클론한 모두와 공유 | 팀 deploy 플로, API 규약, /run-skill-generator 산출물 |
| 커뮤니티 | ~/.claude/skills/ 또는 npx skills add |
개인·교차 프로젝트 | handoff、grill-me、Vercel suite、Firecrawl |
2.1 Capability Uplift vs Encoded Preference
이 이분법으로 무의미한 설치 약 80% 제거:
- Capability Uplift: 없으면 Claude가 reliably 못 함 — Playwright 실브라우저, PDF 폼, CodeQL 등. 새 툴체인.
- Encoded Preference: 원래는 되지만 팀 방식으로 — Karpathy 4원칙, Vercel 57규칙, PR 템플릿.
출력이 너무 일반적이면 Encoded Preference 부족. '아예 못 한다'면 Capability Uplift 부족.
3. 5차원 비교: 진입·실행·컨텍스트·비용·권한
동일 헤더로 Skills와 다른 확장 비교 — 'Skills vs Rules vs MCP' 혼동 방지:
| 방식 | 진입 | 실행 | 컨텍스트 | 비용 | 권한 | 적합 |
|---|---|---|---|---|---|---|
| CLAUDE.md | 매 세션 자동 로드 | 프롬프트급, 스크립트 없음 | 전량 상주 | 높은 고정 token | 프로젝트 파일 따름 | 짧은 사실·디렉터리 |
| Skills | /skill-name 또는 자동 라우팅 |
SOP + 선택 scripts/ | 점진적·온디맨드 | 낮은 인덱스 + 히트 시 확장 | 개인/프로젝트/기업 | 반복 워크플로·팀 규범 |
| MCP Server | 도구 호출 | 라이브 API/DB/Git | 도구 결과 재주입 | API+왕복 지연 | 명시 설정·승인 | 외부 시스템 연동 |
| ECC 풀 키트 | Plugin+Hooks | 246+ Skills+메모리 Hooks | Hooks 세션 간 요약 | 설치+Hook 비용 | 팀 통일 profile | 대규모 팀 엔지니어링 |
ECC(Everything Claude Code)는 기업용 키트급. 개인은 본문 P0–P4 점진 설치 권장. ECC 가치 있나 참고.
4. P0–P4 설치 우선순위(의사결정 핵심)
본문 최중요 표 — 인기순이 아닌 우선순위순:
| 우선순위 | 스킬/조합 | 유형 | 설치 | 이 순위 이유 |
|---|---|---|---|---|
| P0 | /code-review、/debug、/loop | bundled | 제로 설치 — /code-review 직접 | 리뷰→디버그→제어 루프 주경로 |
| P0+ | /run、/verify、/run-skill-generator | bundled (v2.1.145+) | 복잡 프로젝트는 /run-skill-generator로 기동 레시피 기록 | 단위 테스트 녹색만이 아니라 실행 중 앱 검증 |
| P1 | skill-creator | 공식 Capability | /plugin marketplace add anthropics/skills | 설치만 하고 작성 못 하면 목록이 남의 GitHub에 고정 |
| P1 | Document Skills (pdf/docx/xlsx/pptx) | 공식 Capability | 동일 anthropics/skills | 실파일 읽기/쓰기 — 'PDF 흉내' 아님 |
| P2 | grill-me、handoff | 커뮤니티 워크플로 | npx skills add mattpocock/skills -y -g | 착수 전 정렬+세션 인계로 컨텍스트 부패 방지 |
| P2 | superpowers、Karpathy Guidelines | Encoded Preference | skills.sh 또는 GitHub clone ~/.claude/skills/ | 다단계 TDD+먼저 생각 규율 |
| P3 | Vercel 3종(React/UX/Composition) | 스택 특화 | vercel-labs 공식 | React/Next 팀 ROI 최대 |
| P3 | frontend-design、webapp-testing | Capability | anthropics/skills + Playwright | UI 품질+실브라우저 회귀 |
| P3 | Trail of Bits Security | Capability | 공식 파트너 플러그인 | CodeQL/Semgrep 취약점 스캔 |
| P4 | Firecrawl、Remotion、Caveman、Context Mode | 시나리오 특화 | 각 공식 CLI/skills add | 크롤·영상·token 절약·세션 복구 — 명확한 필요 시만 |
5. 18개 스킬 개별 리뷰
티켓·내부 테스트 실제 호출 빈도순. 한 줄 판단 근거. 공식 문서: Extend Claude with skills.
5.1 P0: bundled 내장(모르는 사람이 많음)
/code-review— diff 구조화 리뷰, 가벼운 "봐줘"보다 체크리스트 한 단계. PR 전마다./debug— 체계적 디버깅 유도, Agent 무작위 수정 방지. 커뮤니티systematic-debugging과 같지만 제로 설치./loop— 일괄 rename·다중 파일 마이그레이션 등 반복 작업을 제어 루프로. 수동 bash for보다 안전./run+/verify— 2026 bundled 최고의 "제품감" 조합: 앱 기동 후 런타임 검증. 복잡 monorepo는/run-skill-generator로 DB·env·다단 빌드를.claude/skills/run-*/에 기록./batch— 대량 파일 작업 오케스트레이션. codegen 후 기계적 마무리.
5.2 P1: 공식 필수
skill-creator— 대화형SKILL.md생성. 2026 메타 스킬: 직접 못 쓰면 목록이 남의 GitHub에 고정.- Document Skills — PDF 양식, DOCX 주석, XLSX 파싱. Capability Uplift: 없으면 "설명"만, 있으면 실파일 조작.
5.3 P2: 워크플로 삼종
grill-me(Matt Pocock) — 코딩 전 계획 정렬. 잘못된 가정으로 돌진하는 Agent 치료.handoff(Matt Pocock) — 세션을 구조화 markdown으로 압축, 새 세션·Codex worktree 인계. 120k 근처에서/compact보다 "새 스레드 계속"에 적합.superpowers— 다단 서브에이전트 + TDD. 중대형 기능.- Andrej Karpathy Guidelines — 네 규칙: 먼저 생각, 단순, 수술적 편집, 목표 주도. Encoded Preference 모범.
5.4 P3: 스택별
- Vercel Web Design Guidelines — 100+ a11y·UX 감사 규칙.
- Vercel React Best Practices — 57개 React/Next 성능 규칙.
- Vercel Composition Patterns — boolean prop 지옥 대신 합성 컴포넌트.
frontend-design(Anthropic) — UI를 출시 가능 품질로.webapp-testing— Playwright 로컬 E2E.- Trail of Bits Security — CodeQL + Semgrep.
5.5 P4: 명확한 시나리오 있을 때만
- Firecrawl — 신뢰 가능한 크롤·검색. API key 필요.
- Remotion Best Practices — 프로그램atic 비디오(React) 전문. 비디오 팀만.
- Caveman — 서술 제거, ~65% 출력 token 절약.
- Context Mode — shell 노이즈 필터, 세션 리셋 복구.
code-simplifier— 가독성만, 로직 불변. PR 전.
6. 시나리오 매트릭스
| 역할 | P0–P1 | P2 워크플로 | P3 스택 | 비권장 |
|---|---|---|---|---|
| 솔로 풀스택 | bundled 전체+skill-creator | grill-me+handoff+Karpathy | frontend-design+webapp-testing | ECC full 일괄 |
| React/Next 팀 | 동일+Document Skills | superpowers | Vercel 3종 | Remotion(영상 아니면) |
| iOS/macOS 엔지니어 | bundled+/run-skill-generator xcodebuild | handoff(장세션 필수) | Trail of Bits(C/ObjC 혼재) | Linux에 iOS 커뮤니티 스킬 |
| 테크리드/아키텍트 | skill-creator+프로젝트 .claude/skills/ | grill-me 설계 게이트 | ECC minimal(선택) | 미감사 익명 Hub |
| 24/7 Agent 호스트 | bundled+handoff 영속 문서 | Context Mode | Firecrawl(외부 변경) | 노트북 덮개를 프로덕션 |
iOS 팀이 Skills+CI 동일 호스트화면 iOS 18 CI/CD 엔드투엔드 가이드; 다중 worktree는 원격 Mac worktree 단기 임대.
7. 권장 스택
팀 Wiki에 복사할 세 가지 스킬 스택:
【Solo dev · minimal stack】
P0: /code-review /debug /run /verify
P1: skill-creator
P2: grill-me → before starting | handoff → before session switch
Install: npx skills add mattpocock/skills skill=grill-me,handoff -y -g
【React product team stack】
Minimal stack +
P3: vercel-react-best-practices vercel-web-design-guidelines
frontend-design webapp-testing
Project-level: .claude/skills/deploy/SKILL.md (team release SOP)
【Security-sensitive backend stack】
Minimal stack +
P3: trail-of-bits-security (CodeQL + Semgrep)
P2: Karpathy Guidelines (surgical edit discipline)
Forbidden: unaudited community skills with scripts/
8. 여섯 가지 오해
- 오해1: 스킬 많을수록 좋다 — 인덱스는 가볍지만 모호한 description은 라우팅 혼란. P0–P2 먼저.
- 오해2: bundled 불필요 —
/run,/verify는 2026 플래그십인데 미사용 다수. - 오해3: Skills가 MCP 대체 — Skills는 절차, MCP는 라이브 시스템.
- 오해4: description 넓을수록 트리거 — 역효과. 'Use when user asks to X'.
- 오해5: ECC full이면 선택 끝 — 246+Hooks 학습·충돌 비용.
- 오해6: 노트북 덮개 무관 — 장세션·
/loop는 호스트 상시 온라인. Cloud Mac.
9. 7단계 도입·48시간 검수
- 버전:
claude --version≥ 2.1.145. - P0: 실제 repo에서
/code-review,/debug. - 복잡 기동 기록:
/run-skill-generator→.claude/skills/run-*/Git. - P1:
/plugin marketplace add anthropics/skills. - P2: mattpocock grill-me,handoff.
- P3: React Vercel 3종, 보안 Trail of Bits — 하나씩 써보고 유지.
- 48h: 노트북 8시간 닫고 SSH 재접속, handoff 확인; 끊기면 Cloud Mac 임대로 24/7.
10. FAQ
Q: Claude Code Skills와 Cursor Skills 호환?
A: 둘 다 Agent Skills. symlink 가능. context: fork 등은 Cursor에서 다를 수 있음.
Q: bundled 설치 필요?
A: 아니오. disableBundledSkills 외 매 세션 사용.
Q: .claude/commands/와 Skills?
A: 2026 통합. 새 워크플로는 Skills.
Q: 커뮤니티 Skills 안전?
A: SKILL.md·scripts/ 감사. anthropics·vercel-labs·trailofbits 우선.
Q: 프로젝트 스킬 Git?
A: .claude/skills/ 버전관리. 개인은 ~/.claude/skills/.
11. 요약
2026 Claude Code Skills 랭킹은 워크플로 갭→설치 순서 지도이지 Star 순위가 아닙니다. P0 무료인데 간과; P1 skill-creator가 자작 여부 결정; P2 grill-me·handoff가 정렬·인계 해결. 분수령은 라우팅 가능한 워크플로 진입점.
Cloud Mac 24/7 Claude Code+Skills
Skills 가치는 반복 호출 — ~/.claude/skills/, 프로젝트 스킬, MCP에 24/7 macOS 필요. M4 통합 메모리·Unix로 CI 재사용.
팀 상시 Agent로 전환 시 kvmboot M4 48시간 일임대 검수 — 요금 보기, P0–P2 후 월정.