클로드코드 스킬(Claude Code Skill)은 특정 작업을 어떻게 처리할지 적어둔 매뉴얼 파일(SKILL.md)로, 클로드코드(Claude Code)가 해당 작업을 할 때 자동으로 읽고 그대로 따라요. 매번 같은 규칙을 설명하는 대신 파일 하나에 적어두면 새 대화에서도 같은 품질로 일하고, 필요할 때만 로드돼서 토큰도 절약돼요. 개념, CLAUDE.md와의 차이, 5분 만에 만드는 법, 제가 실제로 쓰는 스킬 스택까지 정리했어요.
클로드코드를 쓰다 보면 “어제도 이 규칙 설명했는데 오늘 또 설명하고 있네?” 하는 순간이 와요. 그 반복을 없애는 기능이 스킬이고, 이 글은 스킬 시리즈의 개념편이에요. 비용과 사용량 한도 이야기는 클로드코드 비용 정리에서 먼저 다뤘어요.
클로드코드 스킬이란 무엇인가요?
회사에 신입이 들어오면 업무 매뉴얼을 줘요. “보고서는 이 양식으로, 배포 전엔 이 체크리스트로” 하는 식이죠. 매뉴얼이 있으면 매번 말로 설명할 필요가 없어요.
스킬이 정확히 그거예요. 특정 작업을 어떻게 처리할지 적어둔 매뉴얼 파일이고, 클로드코드가 그 작업을 할 때 자동으로 읽고 따라요. 실제 파일 모양은 아래와 같아요.
폴더에 SKILL.md 파일 하나를 만들고 이름(name), 설명(description), 규칙을 적으면 끝이에요. 코딩이 아니라 그냥 글쓰기예요.
매번 프롬프트로 설명하는 것과 무엇이 다른가요?
- 반복이 사라져요. 한 번 적어두면 내일도, 다음 달에도, 새 대화에서도 같은 규칙으로 일해요.
- 품질이 일정해져요. 그때그때 설명하면 빼먹는 항목이 생기는데, 매뉴얼은 빼먹지 않아요.
- 사용량을 아껴요. 스킬은 해당 작업을 할 때만 로드돼요. 모든 규칙을 대화에 늘 들고 다니는 것보다 토큰이 절약돼요.
CLAUDE.md와 스킬(SKILL.md)의 차이는?
비슷한 역할의 CLAUDE.md라는 파일도 있는데, 적용 범위와 로드 시점이 달라요.
| 구분 | CLAUDE.md | 스킬 (SKILL.md) |
|---|---|---|
| 성격 | 프로젝트 전체 규칙 | 특정 작업의 매뉴얼 |
| 로드 시점 | 항상 | 그 작업을 할 때만 |
| 예시 | “이 프로젝트는 한국어로 소통” | “블로그 글은 이 구조로 작성” |
정리하면 항상 지켜야 할 규칙은 CLAUDE.md에, 특정 작업에서만 필요한 절차는 스킬에 넣으면 돼요.
클로드코드 스킬 만드는 방법 (5분)
- 프로젝트 폴더 안에 .claude/skills/원하는이름/ 폴더를 만들어요.
- 그 안에 SKILL.md 파일을 만들고, 위 그림처럼 name과 description, 규칙을 적어요.
- 끝이에요. 클로드코드에서 /원하는이름 으로 직접 부르거나, 관련 작업을 시키면 알아서 참고해요.
더 쉬운 방법도 있어요. 클로드코드에게 “내가 방금 말한 규칙을 스킬로 만들어 줘”라고 하면 AI가 스킬 파일을 직접 만들어 줘요. 저도 대부분 이렇게 만들어요.
실제로 쓰는 클로드코드 스킬 스택
직접 만든 것 외에, 공개된 스킬을 설치해서도 써요. 제 필수 스킬 몇 가지만 미리 보면 이래요.
- rtk : 명령 출력을 최대 90% 압축해서 사용량을 아껴주는 도구
- ponytail : AI에게 “게으른 시니어 개발자” 마인드를 심어서 꼭 필요한 최소한의 코드만 쓰게 하는 스킬. 과잉 구현을 막아줘요
- graphify : 코드베이스 전체를 지식 그래프로 만들어서, 큰 프로젝트도 적은 토큰으로 구조를 파악하게 해주는 스킬
- gstack : QA, 코드 리뷰, 배포, 기획 검토까지 실무 워크플로를 통째로 담은 스킬 모음
- 글쓰기 스킬 : 이 블로그의 원고 규칙(어투, 구조, 이미지 스타일). 직접 만들었어요
시리즈에서 이 스킬들을 하나씩 뜯어봐요. 첫 타자는 구독 비용을 아끼는 효과가 제일 큰 rtk예요.
자주 묻는 질문 (FAQ)
Q. 클로드코드 스킬은 유료인가요?
아니요, 스킬은 그냥 텍스트 파일이라 무료예요. 직접 만들면 비용이 들지 않고, 공개된 스킬도 대부분 무료로 설치할 수 있어요.
Q. 코딩을 알아야 스킬을 만들 수 있나요?
아니요, 규칙을 한국어로 적을 수만 있으면 돼요. 그마저도 AI에게 “스킬로 만들어 줘”라고 시키면 됩니다.
Q. 프롬프트를 복붙하는 것과 뭐가 다른가요?
스킬은 파일로 남아서 언제든 자동으로 적용돼요. 복붙은 매번 해야 하고 대화가 바뀌면 사라지니까, 스킬을 “저장되는 프롬프트”라고 생각하시면 편해요.
Q. 스킬은 몇 개까지 만들 수 있나요?
제한 없이 만들 수 있어요. 저는 수십 개를 쓰고 있고, 필요한 것만 그때그때 로드되니까 많다고 무거워지지 않아요.
다음 글: 스킬 1편 rtk
다음 글은 스킬 시리즈 1편, rtk로 클로드코드 토큰 절약하기예요. 클로드코드 사용량(=돈)을 아끼는 효과가 가장 확실한 도구라서 첫 타자로 골랐고, 명령 출력이 어떻게 90% 압축되는지 실측 수치로 보여드려요.
Leave a Reply