요즘 'Claude 스킬'이 자주 언급된다. 그런데 정확히 뭔지, MCP랑 뭐가 다른지, 내 걸 어떻게 만드는지는 잘 안 와닿는다. 이 글에서 한 번에 정리한다.

스킬이 뭔가

스킬은 Claude에게 '이 작업은 이렇게 하라'를 담아둔 설명서 폴더다. 폴더 안에 SKILL.md 파일 하나(필요하면 참고 스크립트·예제도)를 넣어두면, 관련 작업이 나올 때 Claude가 그 폴더를 스스로 열어 읽고 그대로 따른다.

핵심은 필요할 때만 불러온다는 점이다. 항상 긴 지시를 프롬프트에 달고 다니는 게 아니라, Claude가 'PDF 작업이네? PDF 스킬 열어보자'처럼 그 순간에만 꺼내 쓴다. 그래서 지시를 매번 반복하지 않아도 되고, 여러 전문 능력을 가볍게 붙여둘 수 있다.

MCP랑 뭐가 다른가

• MCP = AI에 '외부 도구·데이터를 연결'하는 통로(슬랙·깃허브·파일 등 바깥과 연결).

• 스킬 = AI에게 '특정 작업을 하는 방법·노하우'를 가르치는 설명서(연결이 아니라 방법).

• 둘은 경쟁이 아니라 보완 관계다. MCP로 도구를 붙이고, 스킬로 그 도구를 잘 쓰는 법을 가르치는 식으로 같이 쓴다.

SKILL.md 구조

스킬의 심장은 SKILL.md 맨 위의 몇 줄이다.

---
name: pdf-filler
description: PDF 양식의 빈칸을 채운다. 사용자가 PDF 서식에 값을 입력해 달라고 할 때 사용한다.
---

# 작업 순서
1. 양식의 필드 목록을 파악한다
2. 사용자가 준 값을 해당 필드에 매핑한다
3. 채운 PDF를 저장한다

• name — 스킬 식별자. 소문자·하이픈(예: pdf-filler).

• description — 무엇을 + 언제 쓰는지. Claude가 이 문장만 보고 스킬을 꺼낼지 판단하므로 가장 중요하다. '언제 쓰는지'를 꼭 넣는다.

• 그 아래 본문 — 실제로 따라야 할 순서·규칙·예시.

어디에 넣나 (Claude Code 기준)

프로젝트 폴더 안 .claude/skills/<스킬이름>/SKILL.md 경로에 두면 그 프로젝트에서 자동 인식된다. 모든 프로젝트에서 쓰고 싶으면 홈 디렉터리의 ~/.claude/skills/ 아래에 둔다. claude.ai에서는 인터페이스로 업로드한다.

잘 만드는 요령

• description에 '언제'를 넣어라 — '커밋 메시지를 쓸 때 사용' 처럼 발동 조건이 분명해야 제때 불려 나온다.

• 짧고 구체적으로 — 장황한 설명보다 '순서 1·2·3 + 예시 하나'가 훨씬 잘 먹힌다.

• 예시를 꼭 넣어라 — 이상적인 입력→출력 예시 하나가 규칙 열 줄보다 낫다.

출처와 다운로드

하단 첨부파일로 바로 채워 쓰는 SKILL.md 템플릿을 받을 수 있다. 이걸 .claude/skills/my-skill/SKILL.md로 저장하고 내용만 바꾸면 나만의 첫 스킬이 완성된다. 공식 스킬 예시는 이 게시판의 'Claude 공식 스킬 모음' 글과 참고링크를 참고하자.