Claude Skills 가 뭐예요?
재사용 가능한 지시문, Claude에게 내 작업 흐름 가르치기
⏱ 예상 ~7분
01 · 읽기
Claude Code로 계속 프로젝트를 만들어 왔어요. 하지만 새 대화를 열 때마다 내 선호를 다시 설명해야 해요 - 코드 스타일, 커밋 메시지 형식, 테스트 방식, 프로젝트 컨벤션.
만약 Claude가 내 작업 흐름 규칙을 영구적으로 기억할 수 있다면요?
그게 바로 Claude Skills 예요. Skill 은 Claude가 정확히 어떻게 일해야 하는지 알려주는 재사용 가능한 지시문 파일이에요. 규칙을 한 번만 적으면 Claude가 모든 대화에서 자동으로 그걸 따라요.
반복 설명도 없고, 일관성 없는 결과물도 없어요. 내가 원하는 방식으로 일하는 Claude 예요.
💡 상상해 봐요Skill 을 새 동료를 훈련시키는 것이라고 생각해 보세요. 매일 아침 팀 컨벤션을 설명하는 대신, 팀 핸드북에 적어두는 거예요. Skill 은 Claude 의 핸드북이에요 - 영구적이고, 재사용 가능하고, 언제든 업데이트할 수 있어요.
핵심 정리
- 새 Claude Code 대화는 매번 처음부터 시작해요 - 과거의 선호를 기억하지 않아요
- Skill 은 Claude가 자동으로 불러오는 재사용 가능한 지시문 파일이에요
- 한 번 작성하면 그 프로젝트의 모든 대화에서 Skill 이 적용돼요
- Skill 은 말하지 않은 규칙을 영구적이고 공유 가능한 지시문으로 바꿔줘요
02 · 읽기
Claude Skill 은 안에 SKILL.md 파일이 든 폴더예요. 그게 다예요.
SKILL.md 는 자연어로 쓴 지시문을 담고 있고, 맨 위에 YAML metadata 를 선택적으로 넣을 수 있어요. 참고 파일 - 스타일 가이드나 데이터베이스 schema 같은 것 - 도 같이 두어 Claude에게 추가 컨텍스트를 줄 수 있어요.
Skill 은 Claude가 찾아보는 특정 폴더에 들어가요: - 프로젝트 skill 은 .claude/skills/ 에 두면 그 프로젝트에서만 불러와져요 - 사용자 skill 은 ~/.claude/skills/ 에 두면 내 컴퓨터의 모든 프로젝트에서 불러와져요
Skill 이 활성화되면 Claude 는 그 지시문을 읽고 따라요. 내가 직접 대화창에 타이핑한 것처럼요.
핵심 정리
- Skill = SKILL.md 파일이 든 폴더
- SKILL.md 는 두 부분으로 나뉘어요: YAML frontmatter (metadata) + 마크다운 body (지시문)
- 선택사항: 같은 폴더의 참고 파일이 추가 컨텍스트를 제공해요
- 프로젝트 skill: .claude/skills/ — 사용자 skill: ~/.claude/skills/
03 · 코드 예제
최소 구성의 skill 이 디스크에서 어떻게 생겼는지 봐요 - 폴더 하나, 파일 하나예요.
폴더 구조
.claude/skills/my-skill/
└── SKILL.md
SKILL.md 내용
---
name: My First Skill
description: A simple example skill
---
When working on this project, always use TypeScript strict mode.
Prefer functional components over class components.
Use camelCase for variables and PascalCase for components.
--- 줄은 YAML frontmatter 의 표시예요 - skill 의 metadata 죠. 닫는 --- 아래는 전부 지시문 본문이에요 - 이 skill 이 활성화되면 Claude가 따르는 자연어 규칙이에요.
04 · 퀴즈
새 Claude Code 대화를 시작할 때 어떤 일이 벌어지는지 생각해 봐요. Claude Skill 이 해결하는 주된 문제는 뭘까요?
- 새 대화마다 내 선호를 다시 설명해야 한다
- Claude Code가 너무 느리게 동작한다
- Claude Code 는 skill 없이는 파일을 읽지 못한다
- Claude Code가 TypeScript 를 지원하지 않는다
05 · 빈칸 채우기
각 skill 폴더의 메인 파일 이름은 _____.md 예요
06 · 읽기
Claude Code 는 정해진 위치에서 skill 을 찾아요. 대화창에서 /skill 을 타이핑하면 Claude가 활성화할 수 있는 모든 skill 을 나열해요.
하지만 skill 은 보관 위치에 따라 자동으로 불러올 수도 있어요: - 프로젝트 skill 은 repo 안의 .claude/skills/ 에 두면 좋아요 - 그 프로젝트의 모든 개발자가 따라야 하는 팀 컨벤션에 적합해요 - 사용자 skill 은 홈 디렉토리의 ~/.claude/skills/ 에 두면 좋아요 - 모든 프로젝트에 걸쳐 따라다니는 개인 선호에 적합해요
프로젝트 skill 은 "우리 API 는 kebab-case URL 을 쓴다" 나 "우리는 Conventional Commits 를 쓴다" 같은 것에 좋아요. 사용자 skill 은 "항상 설명해줘" 나 "항상 테스트를 제안해줘" 같은 것에 좋아요.
핵심 정리
- /skill 명령으로 사용 가능한 skill 을 나열하고 활성화할 수 있어요
- 프로젝트 skill (.claude/skills/) 은 git 을 통해 팀과 공유돼요
- 사용자 skill (~/.claude/skills/) 은 개인용이고 모든 프로젝트에서 작동해요
- 프로젝트 skill = 팀 컨벤션; 사용자 skill = 개인 선호
07 · 퀴즈
팀 규칙으로 모든 API route 가 kebab-case URL 을 쓰도록 정했어요. Claude Code를 쓰는 모든 개발자가 자동으로 따르게 하고 싶어요. 이 skill 을 어디에 둬야 할까요?
- 내 모든 프로젝트에 적용되는 ~/.claude/skills/
- 프로젝트 repo 안의 .claude/skills/
- 바탕화면의 텍스트 파일
- 소스 코드 안의 주석
08 · 빈칸 채우기
내 컴퓨터의 모든 프로젝트에 적용되는 skill (개인 선호) 은 ~/._____/skills/ 에 저장해요
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.