Claude Code의 스킬과 서브에이전트 MCP — AI 코딩 어시스턴트의 새로운 패러다임

들어가며

AI 코딩 어시스턴트를 쓰다 보면 한 가지 의문이 생긴다. "이걸 매번 설명해야 하나?" 프로젝트마다 반복되는 컨벤션, 디버깅 절차, 배포 워크플로우를 매 대화마다 다시 가르치는 건 비효율적이다. Claude Code는 이 문제를 **스킬(Skill)**과 서브에이전트(Sub-agent) + MCP라는 두 가지 메커니즘으로 풀었다.

스킬(Skill)이란?

스킬은 Claude Code에 장착할 수 있는 재사용 가능한 지식 모듈이다. 마크다운 파일 하나가 곧 하나의 스킬이 된다.

스킬의 구조

---
name: my-skill
description: 이 스킬이 언제 트리거되는지 한 줄 설명
---

## 실제 지침 내용
- 어떤 도구를 쓸 것인지
- 어떤 순서로 작업할 것인지
- 어떤 규칙을 지킬 것인지

핵심은 description 필드다. Claude는 사용자의 요청을 받으면 등록된 스킬들의 description을 훑어보고, 관련성이 있으면 해당 스킬을 자동으로 로드한다. "1%라도 관련될 것 같으면 일단 로드하라"는 것이 설계 철학이다.

스킬의 종류

유형	예시	특징
프로세스 스킬	TDD, 디버깅, 브레인스토밍	작업 방법을 정의. 엄격하게 따름
구현 스킬	Expo 앱 디자인, Drizzle ORM	특정 기술 스택의 베스트 프랙티스
도구 스킬	Playwright, Obsidian CLI	외부 도구와의 통합 방법

CLAUDE.md와의 차이

CLAUDE.md는 프로젝트 전체에 적용되는 고정 컨텍스트(아키텍처, 명령어, 컨벤션)다. 반면 스킬은 필요할 때만 동적으로 로드된다. CLAUDE.md가 "이 건물의 설계도"라면, 스킬은 "특정 공사에 투입되는 전문 기술자의 매뉴얼"이다.

서브에이전트(Sub-agent)란?

Claude Code는 복잡한 작업을 만나면 별도의 에이전트를 생성해서 위임할 수 있다. 이것이 서브에이전트다.

왜 서브에이전트가 필요한가?

컨텍스트 보호 — 메인 대화 창에 수천 줄의 검색 결과를 쏟아붓는 대신, 서브에이전트가 탐색하고 요약만 돌려준다.
병렬 처리 — 독립적인 작업 여러 개를 동시에 실행할 수 있다. 테스트 실행과 린트 검사를 병렬로 돌리는 식이다.
전문화 — 코드 리뷰 에이전트, 탐색 에이전트, 테스트 에이전트 등 역할별로 특화된 에이전트를 쓸 수 있다.

서브에이전트의 종류

general-purpose  — 범용 리서치, 멀티스텝 작업
Explore          — 코드베이스 빠른 탐색 (quick/medium/very thorough)
Plan             — 아키텍처 설계, 구현 계획 수립
code-review      — 코드 품질 검토, 리팩토링 제안
qa-testing       — 테스트 시나리오 작성, 커버리지 분석
documentation    — API 문서, README, 가이드 생성
security         — 보안 취약점 분석, OWASP 기준 검토

메인 에이전트가 오케스트라의 지휘자라면, 서브에이전트들은 각 파트의 연주자다.

MCP(Model Context Protocol)란?

MCP는 Claude가 외부 도구 및 서비스와 통신하는 표준 프로토콜이다. 브라우저 자동화, 디자인 툴, 데이터베이스, 심지어 게임 엔진까지 — MCP 서버만 있으면 Claude가 직접 제어할 수 있다.

MCP의 동작 방식

사용자 요청
    ↓
Claude Code (메인 에이전트)
    ↓
MCP 클라이언트 → MCP 서버 → 외부 서비스
                              (Chrome, Figma, Obsidian, Unity...)
    ↓
결과 반환 → Claude가 해석 → 사용자에게 응답

실제 예시: 브라우저 자동화

"로그인 페이지 테스트해줘"
    ↓
Claude → MCP(Playwright) → 브라우저 실행
    → 페이지 이동 → 폼 입력 → 스크린샷 → 결과 보고

MCP가 특별한 이유

기존에는 AI에게 "이 웹사이트 확인해봐"라고 하면 학습 데이터에 의존한 추측만 가능했다. MCP를 통하면 실시간으로 실제 시스템과 상호작용한다. 읽기만 하는 게 아니라 쓰기, 실행, 제어까지 가능하다.

세 가지가 만나면

스킬, 서브에이전트, MCP는 독립적으로도 강력하지만, 조합될 때 진가를 발휘한다.

시나리오: "이 컴포넌트의 E2E 테스트 작성해줘"

스킬 로드 — e2e-test-writer 스킬이 자동 활성화. 테스트 작성 절차와 규칙을 로드.
서브에이전트 생성 — 컴포넌트 코드를 분석할 Explore 에이전트가 병렬로 투입.
MCP 호출 — Playwright MCP를 통해 실제 브라우저에서 컴포넌트를 렌더링하고 인터랙션 테스트.
결과 통합 — 메인 에이전트가 분석 결과 + 브라우저 테스트 결과를 종합해 테스트 코드 생성.

이 전체 과정이 하나의 대화 안에서, 사용자 개입 최소화로 이루어진다.

마치며

Claude Code의 스킬/서브에이전트/MCP 아키텍처는 결국 하나의 질문에 대한 답이다: "AI 어시스턴트가 진짜 동료처럼 일하려면 무엇이 필요한가?"

기억(스킬) — 반복 설명 없이 전문 지식을 꺼내 쓴다.
위임(서브에이전트) — 혼자 다 하지 않고 적절히 나눠서 처리한다.
행동(MCP) — 말로만 하지 않고 실제 시스템을 조작한다.

이 세 가지가 AI 코딩 어시스턴트를 "똑똑한 자동완성"에서 "실제로 일하는 팀원"으로 바꿔놓고 있다.