01-개념

01. 개념 — 스킬은 “도구가 아니라 플레이북”

“Skills extend what Claude can do. Create a SKILL.md file with instructions, and Claude adds it to its toolkit. Claude uses skills when relevant, or you can invoke one directly with /skill-name.”
의역: “스킬은 Claude가 할 수 있는 일을 확장한다. SKILL.md로 지시문을 적으면 Claude가 자기 툴킷에 추가한다. 관련 상황에서 Claude가 자동으로 쓰거나, /스킬-이름으로 직접 부를 수도 있다.”
— Anthropic, Extend Claude with skills

스킬과 슬래시 커맨드의 결정적 차이는 자동 호출과 보조 파일이다. 명령은 사람이 부를 때만 동작한다. 스킬은 description을 보고 모델이 “이게 지금 필요하다”고 판단하면 스스로 가져온다.

번들 스킬 (built-in)

Claude Code는 몇 개의 번들 스킬을 기본 탑재한다. 이들은 단순 매크로가 아니라 프롬프트 기반 플레이북이다 — 모델이 실제로 도구를 어떻게 조합할지 안내한다.

“Bundled skills are prompt-based: they give Claude a detailed playbook and let it orchestrate the work using its tools. This means bundled skills can spawn parallel agents, read files, and adapt to your codebase.”
의역: “번들 스킬은 프롬프트 기반이다. Claude에게 자세한 플레이북을 주고 그 안에서 도구를 조율하게 한다. 그래서 번들 스킬은 병렬 에이전트를 띄우고, 파일을 읽고, 코드베이스에 적응할 수 있다.”

대표적인 번들 스킬:

스킬	용도
/batch <지시>	5~30개 단위로 작업을 쪼개 worktree마다 백그라운드 에이전트를 띄움
/claude-api	Claude API/Agent SDK 레퍼런스를 컨텍스트에 로드
/debug	디버그 로깅 활성화 + 트러블슈팅
/loop	정해진 간격으로 프롬프트를 반복 실행
/simplify	최근 변경 파일에 대해 3개 리뷰 에이전트를 병렬로 띄움

이 번들 스킬들이 좋은 학습 모델이다 — 자기 스킬도 “정교한 플레이북 + 모델 자유도” 균형으로 적어야 한다.

스킬과 MCP의 분리

sshh의 정리:

“Skills represent agent autonomy’s third stage, formalizing the ‘scripting’ model over rigid API abstractions like MCP, which the author reserves for stateful environments (such as Playwright) requiring security gateways.”
의역: “스킬은 에이전트 자율성의 3단계다 — MCP 같은 경직된 API 추상화 대신 ‘스크립팅’ 모델을 형식화한다. MCP는 보안 게이트웨이가 필요한 stateful 환경(Playwright 등)에만 쓴다.”

요약: 상태가 있고 외부 시스템과 길게 대화해야 하면 MCP, 그 외엔 스킬이 정답이다.