🧩 Claude Code Skills 완전 가이드 — 클로드 코드 무료 학습

Skills = Claude Code의 레시피북

매번 Claude Code에게 “보고서는 이 양식으로, 한국어로, 표 포함해서...” 반복 설명하는 거 귀찮지 않으세요?

Skills는 이런 반복 설명을 한 번만 적어두는 거예요. 다음부터는 Claude가 알아서 해요. 요리사한테 레시피를 한 번 알려주면, 그 다음부터는 “그거 만들어줘” 한마디면 되잖아요. Skills가 정확히 그거예요.

요리	Skills
레시피	SKILL.md 파일
재료 (밀가루, 버터 등)	보조 파일 (템플릿, 양식 등)
레시피북 (여러 레시피 모음)	Skills 폴더 (~/.claude/skills/)
요리사	Claude
"그거 만들어줘" 한마디	"보고서 만들어줘" 한마디

한 줄 요약

Skills = Claude의 레시피북. 한 번 만들어두면 매번 처음부터 설명할 필요 없어요.

Skills가 작동하는 방식 — 알아서 골라 읽어요

Claude는 레시피북을 전부 다 외우고 있지 않아요. 대신 제목만 기억하고 있다가, 관련 있는 요리를 시키면 그때 레시피를 펴서 읽어요. 이렇게 하면 메모리를 아끼면서도 필요할 때 전문가처럼 일할 수 있어요.

평소에

"아, 보고서 레시피가 있었지" — 스킬 이름과 한 줄 설명만 기억하고 있어요

레시피북 표지만 훑어보기

Skill은 폴더 하나예요

결국 폴더 하나에 파일 넣는 거예요. 최소한으로 필요한 건 폴더 1개 + SKILL.md 파일 1개. 끝!

스킬 폴더 구조

내-보고서-스킬/
├── SKILL.md     ← 이것만 있으면 됩니다
├── 양식.md       ← (선택) 참고 자료
└── 템플릿.txt    ← (선택) 템플릿 파일

SKILL.md가 핵심이에요. 이 파일 하나만 있으면 Claude가 스킬로 인식해요. 나머지 파일은 필요할 때 하나씩 추가하면 돼요.

복잡하게 생각하지 마세요

폴더 하나, 파일 하나면 스킬이에요. 처음에는 SKILL.md 하나로 시작하고, 나중에 필요하면 참고 자료나 템플릿을 추가하면 돼요.

SKILL.md 파일 — 이렇게 생겼어요

먼저 실제 예시를 보고, 그 다음에 설명할게요.

SKILL.md — 일일 보고서 스킬

---
name: 일일 보고서
description: 매일 아침 뉴스를 수집해서 한국어 보고서를 만드는 스킬
---

# 일일 보고서 작성 규칙

## 할 일
1. AI 관련 뉴스 5개를 수집한다
2. 각 뉴스를 2줄로 요약한다
3. report.html 파일로 저장한다

## 규칙
- 한국어로 작성
- 제목은 날짜를 포함 (예: 2026-03-15 AI 뉴스)
- 디자인은 깔끔한 카드 레이아웃

위에서 --- 사이가 ‘이름표’예요. 아래가 ‘실제 지시사항’이에요.

부분	역할	예시
name	스킬 이름 — 사람이 알아보기 위한 것	일일 보고서
description	한 줄 소개 — Claude가 "이 스킬을 쓸지 말지" 판단하는 기준	매일 아침 뉴스를 수집해서 한국어 보고서를 만드는 스킬
--- 아래 본문	실제 지시사항 — Claude가 따라야 할 규칙과 절차	할 일, 규칙, 양식 등

description이 제일 중요해요. Claude가 이 한 줄을 보고 “이 스킬을 쓸지 말지”를 결정하거든요. 구체적으로 적을수록 정확하게 작동해요.

형식은 그냥 마크다운이에요

특별한 프로그래밍 언어가 아니에요. 메모장에서도 만들 수 있어요. 위 예시를 복사해서 내용만 바꾸면 바로 내 스킬이 돼요.

이미 깔려있는 기본 스킬

Claude Code에는 이미 몇 가지 스킬이 내장되어 있어요. 별도로 설치할 필요 없이 바로 쓸 수 있어요.

📊

Excel 스프레드시트

Claude에게 이렇게 말하면 돼요:

이 데이터로 엑셀 파일 만들어줘

🎤

PowerPoint 발표자료

Claude에게 이렇게 말하면 돼요:

이 내용으로 PPT 만들어줘

📝

Word 문서

Claude에게 이렇게 말하면 돼요:

보고서를 워드 문서로 만들어줘

📄

PDF 양식

Claude에게 이렇게 말하면 돼요:

이 PDF 양식 채워줘

이미 있는 거예요! 그냥 시키면 됩니다

별도 설치 없이 Claude에게 “PPT 만들어줘”, “엑셀 파일 분석해줘”라고 하면 기본 스킬이 자동으로 작동해요.

Skills = Claude의 레시피북

한 번 만들어두면 매번 처음부터 설명할 필요 없이, 전문가처럼 일합니다.

나만의 스킬 만들기 — 2가지 방법

방법 1: Claude에게 시키기 (추천)

가장 쉬운 방법이에요. Claude Code에게 이렇게 말하세요:

Claude Code에 이렇게 말하세요

나만의 일일 보고서 스킬을 만들어줘.
매일 AI 뉴스를 5개 수집해서
report.html로 저장하는 스킬이야.

Claude가 알아서 폴더 만들고, SKILL.md 작성해줘요. 끝!

방법 2: 직접 만들기 (4단계)

폴더 만들기

mkdir ~/.claude/skills/my-report-skill

SKILL.md 파일 만들기

위 예시를 복사해서 내용만 수정하면 돼요

Claude Code 재시작

새로 만든 스킬을 인식하도록 재시작

테스트하기

"일일 보고서 만들어줘" — 스킬이 작동하면 성공!

방법 1을 강력 추천해요

Claude가 알아서 다 해줘요. 폴더 구조, SKILL.md 작성, 테스트까지 한번에요. 직접 만드는 법은 알아두면 좋지만, 실전에서는 시키는 게 훨씬 빨라요.

실전 스킬 5가지 — 이런 걸 만들 수 있어요

구체적인 예시를 보면 감이 올 거예요. 각 스킬마다 Claude에게 뭐라고 말하면 되는지와 SKILL.md에 뭘 적는지를 함께 보여드릴게요.

1. 일일 뉴스 브리핑

“매일 아침 AI 뉴스 요약해줘”

SKILL.md 핵심 내용

---
name: 일일 뉴스 브리핑
description: AI 관련 최신 뉴스를 수집하여 한국어 요약 보고서 생성
---

## 규칙
- 뉴스 5개를 수집하여 각 2줄로 요약
- news-YYYY-MM-DD.html로 저장
- 카드 레이아웃, 한국어

2. 주간 보고서

“이번 주 업무 정리해서 보고서 만들어줘”

SKILL.md 핵심 내용

---
name: 주간 보고서
description: 이번 주 작업을 완료/진행중/예정으로 분류하여 보고서 작성
---

## 규칙
- git log에서 이번 주 작업 수집
- 주요 성과와 이슈 강조
- weekly-report.html로 저장

3. 메일 템플릿

“고객 문의 답변 메일 써줘”

SKILL.md 핵심 내용

---
name: 고객 응대 메일
description: 고객 문의 유형별로 적절한 답변 메일을 한국어로 작성
---

## 규칙
- 정중하고 친절한 톤
- 문의 유형 자동 분류 (배송/환불/기술 등)
- 인사 → 답변 → 추가 안내 → 마무리 순서

4. 디자인 가이드

“우리 브랜드 스타일로 만들어줘”

SKILL.md 핵심 내용

---
name: 브랜드 디자인 가이드
description: 우리 브랜드 색상, 폰트, 레이아웃 규칙을 적용하여 디자인
---

## 규칙
- 메인 색상: #3e6ae1, 배경: 흰색
- 폰트: Pretendard, 둥근 카드 레이아웃
- 로고는 항상 좌상단에 배치

5. 회의록 정리

“회의 내용 정리해서 액션 아이템 뽑아줘”

SKILL.md 핵심 내용

---
name: 회의록 정리
description: 회의 내용을 구조화하고 담당자별 액션 아이템을 추출
---

## 규칙
- 날짜, 참석자, 안건 정리
- 결정 사항과 액션 아이템 분리
- 담당자 + 기한 명시

이 중에 하나 골라서 직접 만들어보세요!

위 예시를 그대로 복사해서 SKILL.md에 붙여넣어도 되고, Claude에게 “이런 스킬 만들어줘”라고 시켜도 돼요.

스킬 공유하기

만든 스킬을 어디에 둘지, 3가지 방법이 있어요.보통은 1번이면 충분해요.

내 컴퓨터에서만 (기본)

~/.claude/skills/ 폴더에 넣으면 끝이에요. Claude Code에서 만든 스킬은 자동으로 여기에 저장돼요.

Claude.ai에서도

웹에서도 쓰고 싶으면 Claude.ai > Settings > Skills에서 업로드하면 돼요.

팀과 공유

Team/Enterprise 요금제를 쓰면 관리자가 팀 전체에 한번에 배포할 수 있어요.

1번이면 충분해요

Claude Code에서 스킬을 만들면 자동으로 ~/.claude/skills/에 저장돼요. 따로 옮기거나 설정할 필요 없어요.

Skills vs MCP — 뭐가 다른 거예요?

이 둘을 헷갈려하는 분이 많은데, 요리사 비유로 생각하면 아주 쉬워요.

Skills = 요리사의 레시피북

Claude가 아는 것 (내부 지식). “보고서는 이 양식으로 써”, “메일은 이런 톤으로 써” 같은 규칙과 절차를 알려주는 거예요.

MCP = 요리사가 쓸 수 있는 도구

Claude가 접근할 수 있는 것 (외부 도구). “Slack에 메시지 보내”, “데이터베이스에서 조회해” 같은 외부 시스템과 연결해주는 거예요.

레시피를 아는 요리사(Skills)에게 좋은 도구(MCP)를 주면? 최고의 요리가 나와요. 둘은 경쟁이 아니라 조합이에요.

항목	Skills	MCP
한마디로	Claude가 아는 것	Claude가 쓸 수 있는 것
비유	요리사의 레시피북	요리사의 도구 (오븐, 믹서 등)
설치	폴더에 파일 추가	MCP 서버 연결
인터넷	불필요 (로컬 파일)	필요할 수 있음
함께 쓰면	레시피대로 + 도구로 = 완벽한 자동화

둘 다 쓰면 시너지가 나요

Skills가 “Slack 메시지는 이런 톤으로 써”를 알고 있고, MCP가 Slack에 실제로 메시지를 보내는 도구를 제공하면 —레시피 + 도구가 합쳐져서 완벽한 자동화가 돼요. 경쟁이 아니라 조합이에요.

Plugins — Skills의 업그레이드 버전

Plugin은 Skills + 도구가 합쳐진 패키지예요. 스마트폰 앱스토어에서 앱을 깔듯이,/plugin install 명령어로 설치하면 끝이에요.

예를 들어 Playwright 플러그인을 설치하면 “웹 자동화 스킬 + 브라우저 조작 도구”가 한 번에 설치돼요. Skills만 쓸 때보다 더 강력한 일을 할 수 있어요.

플러그인 설치는 이렇게

# 플러그인 검색
/plugin search data-analysis

# 플러그인 설치
/plugin install @anthropic/data-analysis

# 설치된 목록 확인
/plugin list

아직 초보라면 Plugins는 나중에 알아도 돼요

Plugins는 Skills의 확장판이에요. 먼저 Skills를 잘 쓸 줄 알게 되면 자연스럽게 Plugins도 쓰게 돼요. Skills부터 시작하세요.

Skills, 이렇게 발전해왔어요

2025.06슬래시 명령어 시작

"/명령어"로 자주 쓰는 프롬프트를 저장할 수 있게 됨 — Skills의 전신

2025.12Skills 정식 출시

폴더 + SKILL.md 시스템으로 체계화. Claude.ai, Claude Code, API 어디서든 동작

2026.01Plugins 출시

Skills + 도구를 패키지로 묶어서 한번에 설치/관리

2026.03계속 개선 중

더 안정적으로, 더 빠르게. 매달 업데이트가 이어지고 있어요

6개월 만에 “프롬프트 저장”에서 “전문가 시스템”으로 진화했어요. 지금 Skills를 잘 이해해두면, 앞으로 나올 기능들도 자연스럽게 따라갈 수 있어요.

잘 만드는 5가지 팁

스킬을 처음 만들 때 이것만 기억하면 돼요.

1. description을 명확하게

Claude가 이걸 보고 “쓸지 말지” 판단해요. “보고서 스킬”보다 “매일 AI 뉴스를 수집해서 HTML 보고서를 만드는 스킬”이 훨씬 잘 작동해요.

2. 한 스킬 = 한 주제

“보고서 + 번역 + 메일”을 한 스킬에 넣지 마세요. 보고서 스킬, 번역 스킬, 메일 스킬로 나누면 각각 더 정확하게 작동해요.

3. 구체적으로 적어주세요

“좋은 보고서 써줘”보다 “3페이지, 표 포함, 요약 먼저, 카드 레이아웃”이 나아요. 구체적일수록 Claude가 정확하게 따라와요.

4. 외부 스킬은 내용 확인

남이 만든 스킬은 설치 전에 SKILL.md를 반드시 읽어보세요. 악의적인 지시가 숨어있을 수 있어요. 검증된 소스(Anthropic 공식 등)에서 받는 게 안전해요.

5. 자주 고쳐가세요

처음부터 완벽할 필요 없어요. 써보고 부족하면 SKILL.md를 수정하면 돼요. 조금씩 다듬어가면 점점 더 좋은 스킬이 만들어져요.

직접 해보기

아래 두 가지 실습 중 하나를 골라서 해보세요.

실습 1: Claude에게 시켜서 만들기 (가장 쉬움)

Claude Code에 아래 내용을 복사해서 붙여넣으세요.

Claude Code에 입력

매주 월요일 주간 보고서를 자동으로 만드는 스킬을 만들어줘.
이번 주 작업을 완료/진행중/다음주로 분류하고,
주요 성과를 강조해줘.

그 다음, “주간 보고서 만들어줘”라고 말해보세요. 스킬이 작동하면 성공!

실습 2: 직접 만들기 (4단계)

터미널에서 한 줄씩 따라해보세요.

단계별 명령어

# 1단계: 스킬 폴더 만들기
mkdir -p ~/.claude/skills/weekly-report

# 2단계: SKILL.md 파일 만들기
cat > ~/.claude/skills/weekly-report/SKILL.md << 'EOF'
---
name: 주간 보고서
description: 이번 주 작업을 정리하여 HTML 주간 보고서 생성
---

## 절차
1. 이번 주 작업 내용을 수집
2. 완료/진행중/다음주 예정으로 분류
3. weekly-report.html로 저장
EOF

# 3단계: Claude Code 재시작

# 4단계: 테스트
claude "주간 보고서 만들어줘"

확인 체크리스트

스킬 1개를 만들었다Claude에게 시켜봤다결과가 나왔다

스킬이 작동하지 않으면 description을 더 구체적으로 바꿔보세요. Claude는 description을 보고 스킬을 쓸지 결정하기 때문에, 내용이 명확할수록 잘 작동해요.

활용 팁 + 출처

반복 작업이 보이면 바로 스킬로

“이 작업 또 하네” 싶으면 그 자리에서 “방금 한 작업을 스킬로 만들어줘”라고 하세요. Claude가 대화 내용을 분석해서 자동으로 만들어줘요.

CLAUDE.md와 함께 쓰면 더 좋아요

CLAUDE.md는 프로젝트 전체의 맥락, Skills는 특정 작업의 레시피예요. 둘을 함께 쓰면 Claude가 맥락을 알면서 전문적으로 일해요.

처음엔 간단하게, 점점 복잡하게

Skills는 쓰면 쓸수록 좋아져요. 처음에는 3줄짜리 간단한 스킬부터 시작하고, 써보면서 규칙을 추가해 나가세요.

Skills = Claude의 레시피북

한 번 만들어두면 매번 처음부터 설명할 필요 없이, 전문가처럼 일합니다.
반복 작업이 보이면, 그 자리에서 바로 스킬로 만들어보세요.

실수	결과	예방법
description을 대충 쓰기	스킬이 작동 안 하거나 엉뚱할 때 켜짐	구체적으로 한 줄 요약 작성
한 스킬에 이것저것 다 넣기	Claude가 헷갈려함	한 스킬 = 한 주제로 분리
외부 스킬 무검증 설치	악의적 지시 실행 위험	설치 전 SKILL.md 내용 확인
처음부터 완벽하게 만들려 함	시작을 못 함	간단하게 시작, 점점 개선

참고 자료

Anthropic Skills 소개 — anthropic.com/news/skills
Agent Skills 기술 문서 — anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
Complete Guide to Building Skills PDF — resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf
Anthropic Skills GitHub — github.com/anthropics/skills
Claude Code Plugins — github.com/anthropics/claude-code/tree/main/plugins
Claude Code Changelog — github.com/anthropics/claude-code/blob/main/CHANGELOG.md