Claude Skills란? 프롬프트가 아닌 '절차 패키지'의 이해 — Claude Skills 실전 활용 매뉴얼 1/7

시리즈: Claude Skills 실전 활용 매뉴얼 (총 7편) | 1편

Claude Skills란? 프롬프트가 아닌 ‘절차 패키지’의 이해

Claude Skills가 뭔지 궁금한데 영어 문서뿐이라 감이 안 잡히지? Skills는 단순 프롬프트가 아니라 SKILL.md로 구성된 절차 패키지야. 이 글에서 3단계 로딩 모델, description 작성법, 프로젝트·MCP와의 차이까지 한 번에 정리해 줄게.

Summary

• Claude Skills는 단순 프롬프트가 아니라 SKILL.md + 리소스 + 코드로 구성된 ‘절차 패키지’야
• 3단계 로딩 모델(Metadata → Instructions → Resources)로 필요할 때만 불러와서 효율적이지
• description 한 줄이 스킬의 자동 발동 여부를 좌우해
• 프로젝트·MCP·커스텀 인스트럭션과 역할이 명확히 다르니까 섞어 쓰면 안 돼

이 글의 대상

• Claude를 쓰고 있지만 Skills 기능은 아직 안 써본 사람
• 프롬프트 복붙에 지쳐서 반복 작업을 자동화하고 싶은 사람
• Skills·프로젝트·MCP 차이가 헷갈리는 사람

목차

1. Skills의 공식 정의
2. 프롬프트 모음 vs 절차 패키지
3. SKILL.md 파일 구조
4. 3단계 로딩 모델
5. description이 중요한 이유
6. 프로젝트·MCP·커스텀 인스트럭션과의 차이
7. 왜 지금 Skills를 배워야 하는지

---

1. Skills의 공식 정의

Anthropic Help Center에서는 Skills를 이렇게 설명해:

“특정 작업을 반복 가능하게 수행하는 방법을 Claude에게 가르치는 기능”

핵심은 반복 가능이라는 단어야. 한 번 잘 만들어 놓으면 매번 같은 품질로 결과물을 뽑아낼 수 있다는 뜻이지. 매번 긴 프롬프트를 복사 붙여넣기 할 필요가 없어져.

---

2. 프롬프트 모음 vs 절차 패키지

많은 사람들이 Skills를 “프롬프트 모음”이라고 오해하는데, 실제로는 폴더 단위의 절차 패키지에 가까워.

구분	프롬프트 모음	Skills (절차 패키지)
형태	텍스트 한 덩어리	SKILL.md + 예시 파일 + 코드 폴더
재현성	복붙할 때마다 미묘하게 달라짐	동일 입력 → 동일 구조 출력
관리	메모장이나 노션에 흩어져 있음	한 폴더에 버전 관리 가능
확장	프롬프트가 길어지면 토큰 낭비	필요한 부분만 로딩(3단계 모델)
공유	텍스트 복사해서 전달	ZIP으로 내보내기/가져오기

정리하면, 프롬프트는 “레시피 메모”이고 Skills는 “레시피북 + 계량컵 + 타이머 세트”라고 생각하면 돼.

---

3. SKILL.md 파일 구조

모든 스킬의 시작점은 SKILL.md 파일이야. 기본 구조는 이래:

---
name: blog-writer
description: "한국어 블로그 글을 SEO 최적화하여 작성"
---

# 블로그 작성 스킬

## 절차
1. 키워드 분석
2. 아웃라인 생성
3. 본문 작성
4. SEO 체크리스트 확인

## 입력
- topic: 주제 (필수)
- tone: 어조 (기본값: 친근한 구어체)

## 출력 형식
- Markdown 파일
- H2/H3 계층 구조

그리고 같은 폴더에 필요하면 이런 것들을 추가할 수 있어:

my-blog-skill/
├── SKILL.md          ← 엔트리 포인트 (필수)
├── examples/         ← 입출력 예시 (선택)
│   ├── input_01.md
│   └── output_01.md
├── templates/        ← 출력 템플릿 (선택)
│   └── blog_template.md
└── utils/            ← 보조 코드 (선택)
    └── seo_check.py

SKILL.md 하나만 있어도 스킬은 동작하지만, 예시와 템플릿을 추가할수록 출력 품질이 확 올라가.

---

4. 3단계 로딩 모델

Skills가 똑똑한 이유 중 하나가 바로 이 로딩 방식이야. 한꺼번에 모든 걸 읽지 않고, 필요한 만큼만 단계적으로 불러와:

단계	로딩 대상	로딩 시점	토큰 비용
Tier 1 — Metadata	name, description	항상 (대화 시작 시)	극소
Tier 2 — Instructions	SKILL.md 본문 (절차, 규칙)	트리거 조건 충족 시	중간
Tier 3 — Resources & Code	examples/, templates/, utils/	Claude가 필요하다고 판단할 때	큰 편

이게 왜 중요하냐면, 스킬을 10개 등록해 놔도 Tier 1(이름·설명)만 항상 올라가고 나머지는 실제로 쓸 때만 로딩되니까 토큰 낭비가 거의 없어. 프롬프트를 통째로 시스템 메시지에 넣는 것보다 훨씬 경제적이지.

---

5. description이 중요한 이유

3단계 로딩에서 Tier 1에 항상 올라가는 게 description이야. Claude는 이 한 줄을 보고 “이 스킬을 지금 써야 하나?”를 판단해.

나쁜 description:

description: "유용한 글쓰기 도구"

→ 너무 모호해서 언제 발동해야 할지 Claude가 판단을 못 해. 결과? 거의 안 불려.

좋은 description:

description: "한국어 블로그 글을 2000~4000자로 SEO 최적화하여 작성. H2/H3 구조, FAQ 포함"

→ 작업 범위, 언어, 분량, 출력 형식이 명확해서 Claude가 정확하게 판단할 수 있어.

description 작성 체크리스트:

1. 무엇을 하는지 (동사 + 목적어)
2. 어떤 조건에서 (언어, 분량, 형식)
3. 핵심 출력물이 뭔지

이 세 가지만 한 문장에 담으면 돼.

---

6. 프로젝트·MCP·커스텀 인스트럭션과의 차이

Claude 생태계에는 비슷해 보이는 기능이 여러 개 있어서 헷갈리기 쉬워. 역할을 비유로 정리해 볼게:

기능	비유	역할	적용 범위
커스텀 인스트럭션	나의 기본 성격 설정	말투, 금칙어, 선호 스타일	모든 대화
프로젝트 (Project)	책상 위에 항상 펴놓은 참고서	배경지식, 자료함, 컨텍스트	프로젝트 내 대화
스킬 (Skill)	필요할 때 꺼내 쓰는 도구 상자	절차, 템플릿, 실행 코드	트리거 시만
MCP	외부와 연결된 파이프라인	API 호출, 데이터 가져오기/쓰기	외부 서비스 연결 시

실전 예시로 보면:

• “항상 한국어로 대답해” → 커스텀 인스트럭션
• “우리 회사 브랜드 가이드라인 참고해” → 프로젝트에 PDF 업로드
• “이 양식대로 보고서 써 줘” → 스킬 호출
• “구글 시트에서 데이터 가져와” → MCP 연결

이렇게 각자 맡은 역할이 다르니까, 전부 스킬에 우겨넣으려 하면 안 돼. 배경지식은 프로젝트에, 절차는 스킬에, 외부 연결은 MCP에 넣는 게 깔끔해.

---

7. 왜 지금 Skills를 배워야 하는지

솔직히 말하면, 지금까지 Claude를 잘 쓰던 사람도 결과물 품질이 들쭉날쭉했을 거야. 같은 요청을 해도 어떤 날은 완벽하고 어떤 날은 엉뚱한 결과가 나오거든.

Skills를 쓰면 이게 달라져:

• 품질이 ‘운’이 아니라 ‘형식’에 좌우돼 — 절차와 예시가 고정되니까 편차가 줄어
• 개인도 나만의 SOP(표준 운영 절차)를 가질 수 있어 — 회사에서만 쓰던 SOP 개념을 혼자서도 적용 가능
• 팀과 공유가 쉬워 — ZIP 하나로 내보내서 동료에게 전달하면 같은 품질로 작업 가능
• 토큰도 아껴 — 매번 긴 프롬프트 대신, 필요한 부분만 로딩하니까 비용 절감

특히 블로그 작성, 보고서 생성, 코드 리뷰 같은 반복 패턴이 있는 작업에서 효과가 극대화돼.

---

핵심 정리

1. Skills는 프롬프트가 아니라 SKILL.md + 리소스 + 코드로 구성된 절차 패키지
2. 3단계 로딩(Metadata → Instructions → Resources)으로 토큰을 효율적으로 사용
3. description 한 줄이 스킬의 자동 트리거를 결정하니까 구체적으로 작성해야 해
4. 프로젝트(배경지식)·스킬(절차)·MCP(외부연결)·커스텀 인스트럭션(말투)은 각자 역할이 달라

FAQ

Q: Skills는 무료 플랜에서도 사용할 수 있어?

A. Claude Pro, Team, Enterprise 플랜에서 사용할 수 있어. 무료 플랜에서는 일부 제한이 있을 수 있으니까 Settings > Capabilities에서 확인해 봐.

Q: SKILL.md 파일 이름은 반드시 대문자여야 해?

A. 맞아, SKILL.md로 대소문자를 정확히 맞춰야 해. skill.md나 Skill.md로 쓰면 인식이 안 될 수 있거든.

Q: 스킬을 몇 개까지 등록할 수 있어?

A. 공식적으로 명시된 개수 제한은 없어. 다만 Tier 1(name, description)은 항상 로딩되니까 너무 많이 등록하면 메타데이터만으로도 토큰을 잡아먹을 수 있어. 실무적으로는 자주 쓰는 10~20개 정도가 적당해.

Q: 기존에 쓰던 시스템 프롬프트를 그대로 SKILL.md에 넣으면 돼?

A. 바로 넣으면 동작은 하지만, 효과가 반감돼. Skills는 절차(Step 1 → Step 2 → …)와 입출력 형식을 명확히 나눠 써야 Claude가 잘 따라가거든. 기존 프롬프트를 “절차 + 입력 + 출력 + 예시”로 리팩터링하는 게 좋아.

Q: MCP와 Skills를 같이 쓸 수 있어?

A. 당연하지! 오히려 같이 쓰는 게 강력해. 예를 들어 MCP로 구글 시트에서 데이터를 가져온 다음, Skills로 정해진 양식의 보고서를 생성하는 식으로 조합할 수 있어.

Q: 스킬을 다른 사람과 공유하려면 어떻게 해?

A. 스킬 폴더를 ZIP으로 압축해서 전달하면 돼. 받는 쪽에서 Customize > Skills에서 가져오기(Import)하면 바로 사용 가능해.

Q: description에 한국어를 써도 되나?

A. 써도 동작은 하지만, 영어로 쓰는 걸 추천해. Claude의 트리거 판단이 영어 description에서 좀 더 정확한 편이거든. 한국어 설명은 SKILL.md 본문에 넣는 게 낫지.

Q: 프로젝트 안에 스킬을 넣을 수 있어?

A. 가능해. 프로젝트에 배경 자료를 넣고, 그 프로젝트 안에서 특정 스킬을 활성화하면 “배경지식 + 절차”를 동시에 활용할 수 있어. 가장 이상적인 조합이야.

참고 자료 (References)

데이터 출처

출처	설명	링크
Claude Help Center	Skills 공식 정의 및 사용법	What are Skills
Agent Skills Overview	3단계 로딩 모델 기술 문서	Agent Skills Overview
Claude Code Docs	Claude Code에서의 Skills 활용법	Skills Docs
Anthropic Resources	Skills 빌딩 가이드 PDF	Complete Guide
Best Practices	Skills 설계 모범 사례	Best Practices

핵심 인용

“Skills teach Claude how to complete specific tasks in a repeatable way.”
— Claude Help Center

다음 편 예고

[2편] Skills 시작 전 필수 점검과 실전 사용 흐름

• Skills 활성화에 필요한 권한 토글 체크리스트
• 외부 스킬(ZIP) 설치 전 보안 검토 포인트
• 찾기 → 선택 → 실행 → 재사용의 4단계 실전 흐름