Claude 심화 5단계 스킬(Skill) 이해하기

 

 

 

 

심화 5단계 스킬(Skill) 이해하기

Claude가 필요할 때만 꺼내 읽는 "업무 매뉴얼 폴더" · 구조부터 켜는 법까지

Claude 심화 과정 5/12 · 2026년 9월 기준 · ⏱ 1시간 · ★ = 꼭 해볼 것

이번 단계에서 배우는 것
3~4단계의 MCP가 Claude에게 손과 발을 달아 줬다면, 스킬은 일하는 방법을 가르쳐 줍니다. 이번 글은 직접 만들기 전, 스킬이 무엇이고 어떻게 움직이는지 이해하는 단계입니다. 직접 만드는 법은 다음 6단계에서 다룹니다.

1. 개념

스킬이 무엇이고, 왜 많이 켜 둬도 가벼운지 (점진적 공개)

2. 구조

스킬 폴더와 SKILL.md 파일을 한 줄씩 뜯어보기

3. 사용

기본 제공 스킬 써 보기, claude.ai와 Claude Code에서 켜는 곳

4. 비교

스킬 · 프로젝트 지침 · CLAUDE.md · 슬래시 명령어는 언제 무엇을 쓰나

1 스킬이란? — 신입사원 업무 매뉴얼 개념

스킬은 특정 업무를 하는 방법을 적어 둔 매뉴얼 폴더입니다. Claude는 일이 들어오면 맞는 매뉴얼을 찾아 펼치고, 거기 적힌 순서와 규칙대로 일합니다.

회사에 신입사원이 들어왔다고 생각해 보세요. 똑똑하지만 우리 회사 방식은 모릅니다. 그래서 선배는 "주간보고는 이 양식으로", "견적서는 이 순서로" 같은 매뉴얼 바인더를 책상에 꽂아 줍니다. 신입은 평소엔 바인더 제목만 알고 있다가, 주간보고를 써야 할 때 그 바인더를 꺼내 펼칩니다.

Claude에게 스킬이 바로 그 바인더입니다. 매번 대화창에 "이 양식으로, 이런 말투로, 이 순서대로…"를 길게 설명할 필요 없이, 한 번 매뉴얼로 만들어 두면 관련 일이 올 때마다 알아서 꺼내 씁니다.

매뉴얼 본문SKILL.md
작업 순서 · 규칙 · 예시

참고 자료reference 파일
양식 샘플 · 용어집 · 가이드

도구scripts 폴더
실행할 스크립트

부속품assets
템플릿 · 로고 · 이미지

MCP와 헷갈린다면 : MCP는 "지메일에 접속할 수 있는 능력", 스킬은 "메일을 이런 기준으로 분류하라는 방법"입니다. 둘은 경쟁 관계가 아니라 함께 쓰는 짝입니다.

2 점진적 공개 — 목차만 보고, 필요할 때 펼친다 핵심 원리

스킬을 10개, 20개 켜 두면 Claude의 기억 공간이 꽉 차지 않을까요? 걱정하지 않아도 됩니다. 스킬은 점진적 공개(progressive disclosure) 방식으로 읽히기 때문입니다.

① 시작할 때 각 스킬의 이름과 description(한 줄 설명)만 읽음 → ② 관련 일이 오면 해당 SKILL.md 본문 전체를 펼침 → ③ 더 필요하면 참고 파일·스크립트를 그때 읽음

책장 비유

책장 앞에서 책등의 제목만 훑어보고, 필요한 책 한 권만 꺼내 읽고, 그 책의 부록은 또 필요할 때만 펼치는 것과 같습니다.

그래서 가벼움

평소에 기억 공간을 차지하는 건 스킬마다 설명 몇 줄뿐입니다. 본문과 참고 자료는 쓸 때만 올라옵니다.

그래서 설명이 중요

★ 반대로 말하면, Claude가 처음에 보는 건 이름과 description 한 줄뿐입니다. 이 한 줄이 부실하면 매뉴얼이 아무리 훌륭해도 꺼내지지 않습니다(4번에서 자세히).

3 폴더 구조와 SKILL.md 해부 구조

스킬은 특별한 프로그램이 아니라 폴더 하나와 마크다운 파일입니다. 필수는 SKILL.md 하나뿐입니다.

tistory-guide-writer/                  # 스킬 폴더 (폴더 이름 = 스킬 이름)
├── SKILL.md                  # 필수: 매뉴얼 본문
├── references/
│   └── sample.html           # 선택: 참고 자료 (필요할 때만 읽음)
└── scripts/
    └── check.py              # 선택: 실행할 스크립트

SKILL.md는 두 부분으로 나뉩니다. 맨 위 --- 사이의 frontmatter(스킬 정보 카드)와, 그 아래 본문(실제 매뉴얼)입니다.

---
name: tistory-guide-writer
description: 모듈비트 티스토리용 Claude 가이드 글을 HTML로 작성할 때 사용. 글 초안, 단계별 튜토리얼, 티스토리 HTML 요청 시.
---

# 블로그 글 작성 매뉴얼

## 작업 순서
1. references/sample.html 의 스타일을 먼저 확인한다
2. 제목 → 부제 → 번호 붙은 섹션 → 체크리스트 순서로 쓴다

## 규칙
- 존댓말(습니다체), 일상적인 비유 하나 이상
- 명령어는 코드 블록에 넣는다

frontmatter 주요 필드

name

스킬 이름. 생략하면 폴더 이름이 쓰이고, Claude Code에서 부르는 /이름 도 폴더 이름을 따르므로 둘을 같게 두는 것이 편합니다. 소문자와 하이픈으로 짧게.

description

★ 무엇을 하는 스킬이고 언제 써야 하는지. Claude가 스킬을 꺼낼지 판단하는 가장 중요한 단서. 사실상 필수입니다.

when_to_use

언제 쓸지 추가 설명(Claude Code). description과 합쳐서 목록에 표시되며, 합계 1,536자를 넘으면 잘립니다.

disable-model-invocation

true 로 두면 Claude가 스스로 꺼내지 않고 내가 /이름 을 입력할 때만 실행. 배포처럼 함부로 돌면 곤란한 작업에.

allowed-tools

이 스킬이 쓸 도구를 지정(Claude Code). 필요한 도구만 적어 권한을 좁힙니다.

argument-hint

/이름 뒤에 무엇을 입력하면 되는지 보여 주는 힌트. 예: [글 주제]

claude.ai에 올릴 때 제한 : 웹·데스크톱 앱에 ZIP으로 업로드하는 스킬은 name 과 description 이 꼭 있어야 하고, name은 최대 64자, description은 최대 200자입니다. Claude Code와 같이 쓸 스킬이라면 처음부터 description을 200자 안으로 짧게 쓰는 게 편합니다. 그 밖의 필드(when_to_use 등)는 주로 Claude Code용입니다.

4 description이 가장 중요한 이유 ★ 핵심

2번에서 봤듯 Claude는 처음에 이름과 description만 봅니다. 도서관 검색창에 뜨는 책 소개 한 줄과 같아서, 여기서 걸러지면 본문은 읽히지도 않습니다.

✔ 무엇을

이 스킬이 하는 일 — "티스토리용 HTML 가이드 글 작성"

✔ 언제

어떤 요청이 오면 써야 하는지 — "블로그 글, 튜토리얼, 티스토리 HTML 요청 시"

✔ 사용자가 쓰는 단어

내가 실제로 말할 법한 표현을 넣기 — "글 써줘", "포스팅", "주간보고"

# 나쁜 예 — 너무 막연해서 언제 꺼낼지 모름
description: 글쓰기 도우미

# 나쁜 예 — 무엇만 있고 "언제"가 없음
description: HTML 문서를 생성하는 스킬

# 좋은 예 — 무엇 + 언제 + 사용자가 쓰는 단어
description: 모듈비트 티스토리용 Claude 가이드 글을 .cckr 스타일 HTML로 작성. 블로그 글, 튜토리얼, 티스토리 포스팅 요청 시 사용.

# 좋은 예 — 업무용
description: 회사 양식에 맞춘 주간보고서를 Word로 작성. "주간보고", "이번 주 업무 정리" 요청 시 사용.

반대 문제도 있습니다 : description을 너무 넓게("모든 문서 작업에 사용") 쓰면 엉뚱한 상황에서도 스킬이 튀어나옵니다. 스킬이 안 불리면 더 구체적으로, 너무 자주 불리면 범위를 좁혀서 고칩니다.

5 ★ 기본 제공 스킬 써 보기 따라해 보기

사실 여러분은 이미 스킬을 써 왔습니다. claude.ai에는 Excel(xlsx) · Word(docx) · PowerPoint(pptx) · PDF 스킬이 기본으로 들어 있고, 관련 요청을 하면 자동으로 쓰입니다.

1. 설정 확인

스킬은 코드 실행(Code execution and file creation) 이 켜져 있어야 동작합니다. Free·Pro·Max는 Settings > Capabilities 에서 확인합니다.

2. 프롬프트 입력

아래 예시 중 하나를 복사해 새 대화에 붙여넣습니다. "스킬을 써줘"라고 말하지 않아도 됩니다.

3. 과정 관찰

작업 과정을 펼쳐 보면 Claude가 해당 스킬의 SKILL.md를 먼저 읽는 모습을 볼 수 있습니다. 이게 "매뉴얼을 펼치는" 순간입니다.

# 엑셀
월별 블로그 방문자 수 예시 데이터로 엑셀 파일을 만들어줘.
1~12월, 방문자 수 · 전월 대비 증감률 열을 넣고, 합계 행과 꺾은선 차트도 추가해줘.

# 워드
"Claude 사내 교육 안내문"을 워드 문서로 만들어줘.
제목, 교육 일정 표, 준비물, 문의처 순서로. A4 한 장 분량.

# 파워포인트
"MCP란 무엇인가"를 주제로 5장짜리 발표 자료를 PPT로 만들어줘.
표지 → 개념(USB-C 비유) → 연결 방법 → 활용 예 → 보안 주의 순서로.

# PDF
첨부한 PDF에서 표만 뽑아서 엑셀로 정리해줘.

관찰 포인트 : 같은 부탁을 해도 결과 파일의 서식이 꽤 정돈되어 나오는 건, 스킬 안에 "이런 도구로, 이런 순서로 만들어라"라는 노하우가 적혀 있기 때문입니다. 6단계에서는 이런 노하우를 내 업무용으로 직접 적어 넣습니다.

6 스킬 켜는 곳 — claude.ai와 Claude Code 설정

같은 스킬이라도 쓰는 곳에 따라 켜는 방법이 다릅니다. 화면은 버전에 따라 다를 수 있습니다(새 통합 화면이 순차 적용 중).

claude.ai · 데스크톱 앱

기능 켜기

Free·Pro·Max: Settings > Capabilities 에서 스킬 기능 활성화 (코드 실행도 켜져 있어야 함)

스킬 관리

Customize > Skills 에서 개별 스킬을 켜고 끄거나, 직접 만든 스킬을 업로드합니다(6단계).

Team · Enterprise

관리자가 Organization settings 에서 먼저 허용해야 쓸 수 있습니다.

Claude Code

~/.claude/skills/

개인 스킬 — 내 모든 프로젝트에서 사용. 예: ~/.claude/skills/tistory-guide-writer/SKILL.md

.claude/skills/

프로젝트 스킬 — 이 저장소에서만. 깃에 커밋하면 팀원도 같이 씁니다.

/스킬이름

description이 맞으면 자동으로 쓰이고, 직접 부르고 싶으면 /tistory-guide-writer 주제 처럼 입력합니다.

# Claude Code — 개인 스킬 폴더 만들기 (macOS/Linux)
mkdir -p ~/.claude/skills/tistory-guide-writer
# 이 폴더 안에 SKILL.md 를 만들면 끝. 세션에서 /tistory-guide-writer 로 호출

7 스킬 vs 프로젝트 지침 vs CLAUDE.md vs 슬래시 명령어 비교

모두 "Claude에게 미리 알려 두는 글"이라 헷갈립니다. 차이는 언제 읽히느냐와 어디에 묶여 있느냐입니다.

프로젝트 지침

claude.ai 프로젝트 안의 모든 대화에 항상 적용. "이 프로젝트에서는 늘 이렇게". 예: 모듈비트 티스토리 프로젝트의 "sample.html 스타일로 써줘"

CLAUDE.md

Claude Code에서 해당 폴더 작업 시 항상 읽는 기본 안내문. 빌드 명령, 코딩 규칙 등. 200줄 안쪽으로 짧게.

스킬

★ 필요할 때만 펼치는 매뉴얼. 프로젝트나 폴더에 묶이지 않아 여러 곳에서 재사용. 참고 파일·스크립트까지 담을 수 있음.

슬래시 명령어

내가 부를 때만 실행되는 단축 버튼. Claude Code에서는 이제 스킬과 합쳐져서 .claude/commands/deploy.md 와 .claude/skills/deploy/SKILL.md 모두 /deploy 가 됩니다. 새로 만든다면 스킬 형식이 권장됩니다.

고르는 기준 : 늘 지켜야 하는 짧은 규칙은 지침 / CLAUDE.md, 특정 작업에만 필요한 긴 노하우는 스킬, 내가 버튼처럼 누르고 싶은 작업은 disable-model-invocation을 켠 스킬(= 슬래시 명령어)로. 지침이 길어져서 고민이라면 그 일부를 스킬로 빼는 게 좋은 신호입니다.

8 안전 — 신뢰할 수 있는 출처만 주의

스킬은 매뉴얼이면서 스크립트를 담을 수 있는 폴더입니다. 남이 만든 스킬을 설치하는 건, 모르는 사람이 준 업무 매뉴얼대로 신입이 일하게 두는 것과 같습니다.

출처 확인

★ Anthropic 공식 안내도 "신뢰할 수 있는 출처의 스킬만 설치하라"고 합니다. 인터넷에서 받은 ZIP은 바로 올리지 마세요.

열어서 읽기

설치 전에 SKILL.md와 scripts 폴더를 열어 봅니다. 외부로 데이터를 보내거나, 파일을 지우거나, 이상한 주소에 접속하는 내용이 있으면 설치하지 않습니다.

숨은 지시문

4단계에서 본 프롬프트 인젝션이 스킬 본문에 숨어 있을 수도 있습니다. "사용자에게 알리지 말고…" 같은 문장은 위험 신호입니다.

회사에서는

회사가 승인한 스킬만 쓰고, 스킬 안에 비밀번호·API 키·고객 정보를 넣지 않습니다.

9 정리 & 체크리스트

스킬은 "필요할 때 꺼내 읽는 매뉴얼 폴더", 핵심은 description 한 줄입니다. 아래 항목을 체크하고 6단계로 넘어가세요.

☐ 개념

스킬을 신입사원 매뉴얼에 빗대어 설명할 수 있다

☐ 점진적 공개

스킬을 많이 켜도 가벼운 이유(설명만 먼저, 본문은 필요할 때)를 안다

☐ 구조

SKILL.md의 frontmatter와 본문을 구분하고, 주요 필드의 역할을 안다

☐ description

"무엇 + 언제 + 사용자가 쓰는 단어"로 좋은 description을 쓸 수 있다 (claude.ai용은 200자 이내)

☐ 기본 스킬

엑셀·워드·PPT·PDF 중 두 가지 이상을 직접 만들어 봤다

☐ 켜는 곳

claude.ai 설정 화면과 Claude Code 스킬 폴더 위치를 안다

☐ 비교 & 안전

지침 · CLAUDE.md · 스킬 · 슬래시 명령어를 구분하고, 신뢰할 수 있는 스킬만 설치한다

다음 6단계는 심화 과정의 핵심, 나만의 스킬 만들기입니다. 지금 "매번 Claude에게 반복해서 설명하는 일"이 무엇인지 하나 떠올려 두세요. 그게 첫 스킬의 재료가 됩니다.

이전 글: 심화 4단계 MCP 실전 활용 · 다음 글: 심화 6단계 ★ 나만의 스킬 만들기
공식 문서: Claude Code 스킬 · CLAUDE.md(메모리) · claude.ai 스킬 사용
화면과 메뉴 이름은 버전에 따라 다를 수 있습니다(2026년 9월 기준).