Claude Code·Codex의 Skill이란? MCP와 무엇이 다른가

 

Claude Code, Codex를 쓰다 보면 Skill(스킬)과 MCP라는 말이 자주 나옵니다. 둘 다 에이전트를 강화하는 건데, 헷갈리기 쉬워요. 한 줄로 정리하면 — MCP는 "새 도구"를 주고, Skill은 "그 도구를 쓰는 노하우"를 줍니다. 이 글에서 Skill이 정확히 뭐고 MCP와 어떻게 다른지, 그리고 둘을 함께 쓰는 법까지 정리합니다.

📌 이 글에서 얻어갈 것

✓ Skill(SKILL.md)이 무엇인가
✓ MCP와의 핵심 차이 (도구 vs 플레이북)
✓ 토큰 경제성 — 왜 Skill이 가벼운가
✓ 둘을 함께 쓰는 실전 패턴

Skill이 뭐야?

Skill은 에이전트가 필요할 때만 불러오는 '능력 묶음'입니다. 핵심은 SKILL.md라는 마크다운 파일이에요. 폴더 안에 SKILL.md + (선택) 스크립트·참고자료를 함께 담습니다.

my-skill/
├── SKILL.md        # name + description + 사용법(필수)
├── scripts/        # (선택) 실행 스크립트
└── reference.md    # (선택) 참고 자료

# SKILL.md 안쪽
---
name: pdf-table-extractor
description: PDF에서 표를 뽑아 CSV로 변환할 때 사용
---
# 사용법
1. scripts/extract.py 를 실행한다
2. 결과 CSV를 검증한다 ...

CLAUDE.md(항상 컨텍스트에 있음)와 달리, Skill은 평소엔 로드되지 않습니다. 작업이 SKILL.md의 name·description과 맞을 때만 에이전트가 끌어와 읽어요.

어떻게 동작하나 — 점진적 공개

Skill의 똑똑한 점은 '점진적 공개(progressive disclosure)'입니다. 에이전트는 먼저 각 Skill의 메타데이터(이름·설명)만 훑어보고, 지금 작업에 맞는 게 있으면 그제서야 전체 내용을 불러옵니다.

"Skill은 호출되기 전까진 ~30~50 토큰만 차지한다"
수십 개를 깔아둬도 컨텍스트가 가볍다 — 점진적 공개 덕분

MCP는 뭐였더라?

MCP(Model Context Protocol)는 에이전트를 외부 시스템에 연결하는 표준 규약입니다. GitHub 이슈 읽기, 데이터베이스 질의, Slack 전송, 브라우저 조작처럼 "새로 할 수 있는 일"을 추가하죠. 한마디로 도구(verbs)예요. (MCP가 처음이라면 별도 글 'MCP 5분 이해'를 참고하세요.)

핵심 차이 — 도구 vs 플레이북

MCP = 도구 (verbs) 에이전트가 할 수 있는 일을 늘림. 외부 시스템 접근(GitHub·DB·API·브라우저).

Skill = 플레이북 (how) 그 도구를 내 방식대로 쓰는 절차. "이럴 땐 이렇게 해라"는 노하우.

비유	MCP = 공구(드릴·렌치) / Skill = 조립 설명서
주는 것	MCP=새 능력·연결 / Skill=절차적 지식
토큰 비용	MCP=도구 정의를 미리 로드(5개 서버면 5만+ 토큰) / Skill=호출 전 ~30~50 토큰

💡 한 문장 요약

"MCP는 동사(verbs), Skill은 플레이북." MCP는 무엇을 할 수 있는지를, Skill은 그것을 어떻게 잘 해내는지를 담당합니다.

둘은 경쟁이 아니라 짝꿍

실전 패턴은 명확합니다 — 외부 시스템마다 MCP 하나씩 연결하고(GitHub·Postgres·Linear·Sentry), 그 위에 얇은 Skill을 여러 개 얹어 워크플로를 정의합니다.

1

MCP로 연결
GitHub MCP를 붙여 "이슈 읽기·PR 생성" 능력을 추가.

2

Skill로 절차화
"버그 리포트 처리 Skill" — 이슈를 읽고, 재현하고, 브랜치를 따고, PR을 올리는 우리 팀 규칙을 SKILL.md에 적어둠. MCP를 '어떻게' 쓸지를 정의.

SKILL.md는 사실상 표준

Skill은 한 도구 전용이 아닙니다. SKILL.md 형식이 오픈 표준처럼 자리잡아, Claude Code뿐 아니라 Codex(2025년 12월 도입), Gemini CLI, Cursor, GitHub Copilot 등 20개가 넘는 코딩 도구가 채택했습니다. 한 번 잘 써두면 여러 도구에서 재사용할 수 있어요. (Codex는 ~/.agents/skills/에 두면 자동 인식)

자주 묻는 질문 (FAQ)

Q. Skill이면 MCP는 필요 없나요?

아니요. Skill은 '방법'을 알려줄 뿐, 외부 시스템에 실제로 접근하려면 MCP(또는 CLI 도구)가 필요합니다. 둘은 보완 관계예요.

Q. CLAUDE.md랑은 뭐가 다른가요?

CLAUDE.md는 항상 컨텍스트에 있는 전역 규칙, Skill은 필요할 때만 불려오는 작업별 묶음입니다. 자주 쓰는 큰 노하우는 Skill로 빼면 평소 컨텍스트가 가벼워집니다.

Q. 언제 MCP, 언제 Skill?

외부 시스템에 접근해야 하면 MCP, 무언가를 하는 방법을 알려줘야 하면 Skill. 토큰을 아끼려면 "MCP는 적게, Skill은 많이" 패턴이 정석입니다.

마치며

헷갈렸다면 이 한 문장만 기억하세요 — "MCP는 도구를 쥐여주고, Skill은 그 도구를 쓰는 법을 적어준다." 외부 연결은 MCP로 적게, 반복 노하우는 Skill로 많이. 이 조합이 2026년 에이전트 셋업의 정석입니다.

여러분은 어떤 Skill을 만들어 쓰고 계신가요? 유용한 Skill 아이디어를 댓글로 공유해주세요 🙌

---

※ 본 글은 2026년 6월 기준 자료를 교차검증해 작성했습니다. 주요 출처: claude.com/blog(Skills explained), developers.openai.com/codex/skills, Anthropic·OpenAI 공식 문서. 기능·형식은 업데이트될 수 있으니 공식 문서에서 현행 사양을 확인하세요.