Claude Code Skill은 작업이 Skill 설명과 일치할 때 Claude Code가 필요에 따라 로드하는 SKILL.md 파일이 들어 있는 폴더입니다. 프로젝트의 .claude/skills/에 폴더를 넣으면(모든 프로젝트에서 사용하려면 ~/.claude/skills/에 넣으면 됩니다) Claude Code가 프런트매터를 읽고, 그때부터 관련성이 있을 때마다 해당 지침을 불러옵니다. 아래에서 Skill의 위치, CLAUDE.md·슬래시 명령어·MCP와의 차이, 3단계 설치 방법, 현재 Claude Code에서 작동하는 개발자 Skill 15가지를 설명합니다.
이 페이지
Claude Code Skill이 실제로 무엇인지
Skill은 필수 파일 하나가 있는 디렉터리입니다. SKILL.md, 선택적으로 몇 가지 보조 파일(참조 문서, 템플릿, 간단한 스크립트)이 있습니다. SKILL.md는 Claude Code가 중요하게 여기는 두 필드가 담긴 YAML 프런트매터로 시작합니다. 이름 그리고 description프런트매터 아래에는 역할, 프로세스, 출력 형식, 규칙이 담긴 일반 Markdown이 있습니다.
중요한 설계 결정은 Skill을 지연 로드한다는 점입니다. Claude Code는 설치된 모든 Skill의 이름과 설명으로 구성된 짧은 색인을 컨텍스트에 유지합니다. 요청이 특정 Skill과 일치해 보이면 전체 SKILL.md를 읽고 따릅니다. 일치하지 않으면 해당 Skill은 거의 아무런 비용도 발생시키지 않습니다. 따라서 이 파일에서 무엇보다 중요한 것은 잘 작성된 설명입니다. Claude Code가 Skill을 열지 결정하기 전에 볼 수 있는 유일한 내용이기 때문입니다.
KissMySkills에서 Skill을 구매할 때 받는 것도 동일한 SKILL.md입니다. .md 파일과 README로 구성되며, Claude Project, 사용자 지정 GPT 또는 Gemini Gem에 업로드하는 것과 동일합니다.
Skill이 위치하는 곳: 프로젝트 수준과 사용자 수준
Claude Code는 두 곳을 확인합니다.
-
프로젝트 수준:
<repo>/.claude/skills/<skill-name>/SKILL.md. 이 폴더를 커밋하면 저장소를 복제하는 모든 팀원이 해당 Skill을 사용할 수 있습니다. 코드베이스에 연결된 모든 것, 즉 리뷰 체크리스트, 배포 런북, API 문서 스타일 등에 사용하세요. -
사용자 수준:
~/.claude/skills/<skill-name>/SKILL.md. 컴퓨터의 모든 프로젝트에서 사용할 수 있지만 팀원에게는 보이지 않습니다. 커밋 메시지 작성 방식, 선호하는 테스트 구조, 여러 클라이언트에서 사용하는 페르소나 등 개인적인 습관에 사용하세요.
같은 이름의 스킬이 두 위치에 모두 있으면 프로젝트 수준의 사본이 우선합니다. 일반적인 개발자 스킬은 사용자 수준에 두고, 프로젝트별 규칙이 있는 항목은 프로젝트 수준에 두세요.
Claude Code가 스킬을 검색하는 방식
검색을 결정하는 것은 description 파일 이름이나 폴더 이름이 아니라 프런트매터의 필드입니다. "풀 리퀘스트 코드 리뷰" 같은 설명은 실제로 "리뷰"라고 말할 때만 실행되므로 약합니다. "버그, 보안 문제, 누락된 테스트, 불명확한 이름을 찾기 위해 diff, 풀 리퀘스트 및 변경된 파일을 리뷰하세요. 사용자가 코드를 확인, 리뷰, 감사 또는 비평해 달라고 요청할 때 사용합니다."와 같은 설명은 개발자가 실제로 사용하는 표현에 반응합니다.
알아야 할 세 가지:
- 스킬은 세션이 시작될 때 색인됩니다. 세션 중간에 폴더를 추가했다면 새 세션을 시작하거나 Claude Code에 스킬을 다시 읽어 달라고 요청하세요.
- 설명에는 스킬이 무엇인지뿐 아니라 언제 사용해야 하는지가 담겨야 합니다. 트리거 문구도 설명에 넣으세요.
- 스킬 이름을 지정해 언제든 강제로 사용할 수 있습니다. "이 diff에 코드 리뷰어 스킬을 사용해"라고 말하면 됩니다. 자동 검색은 편의를 위한 기능일 뿐 유일한 방법은 아닙니다.
Skills와 CLAUDE.md, 슬래시 명령, MCP 서버
이 네 가지는 끊임없이 혼동되지만, 서로 다른 문제를 해결합니다.
| 작동 방식 | 무엇인가 | 로드되는 시점 | 적합한 용도 |
|---|---|---|---|
| CLAUDE.md | 저장소 루트(또는 ~/.claude/CLAUDE.md)에 있는 프로젝트 메모리 파일 | 항상, 매 턴마다 | Claude가 절대 잊어서는 안 되는 사실: 기술 스택, 규칙, 명령, 건드리면 안 되는 영역 |
| Skill | SKILL.md와 선택적 지원 파일이 들어 있는 폴더 | 설명과 일치할 때 필요에 따라 | 가끔 필요한 전문가 절차: 리뷰, 감사, 테스트 계획, 런북 |
| 슬래시 명령 | .claude/commands/에 있는 Markdown 파일이며 /name으로 실행 | 명령을 입력했을 때만 | 의도적으로 실행하는 반복 가능한 작업: /deploy-checklist, /write-pr |
| MCP 서버 | 도구를 노출하는 외부 프로세스(데이터베이스, API, 브라우저) | 도구는 세션 내내 사용 가능 | Claude에게 무언가를 수행할 능력을 부여하는 것 - 그것을 잘 수행하는 방법에 대한 지식은 아님 |
짧게 말하면, CLAUDE.md는 항상 켜져 있는 컨텍스트이고, 스킬은 필요할 때 제공되는 전문 지식이며, 슬래시 명령은 직접 누르는 버튼이고, MCP 서버는 작업을 수행하는 손들의 집합입니다. 좋은 구성은 이 네 가지를 모두 사용합니다. MCP로 Claude가 작업하게 하고, 스킬로 시니어 엔지니어처럼 작업하게 하세요.
한 가지 결과는 이렇습니다. 2,000단어 분량의 리뷰 체크리스트를 CLAUDE.md에 붙여 넣지 마세요. 변수를 이름을 바꿀 때도 이 내용이 컨텍스트에 포함됩니다. 대신 스킬로 만드세요.
Claude Code 스킬을 3단계로 설치하기
1단계: SKILL.md를 가져오세요. KissMySkills 주문에서 .md 파일을 다운로드하거나 직접 작성하세요. 파일 이름이 이미 SKILL.md가 아니라면 이름을 바꾸세요. 프론트매터에는 최소한 name:과 description:이 필요하며, 마켓플레이스에서 판매되는 모든 스킬에는 이 두 항목이 포함되어 있습니다.
2단계: 폴더를 만드세요. 저장소 루트에서:
mkdir -p .claude/skills/code-reviewer
mv ~/Downloads/yuri-code-reviewer.md .claude/skills/code-reviewer/SKILL.md를 다음으로 바꾸세요: .claude/skills 사용자 수준 설치의 경우 ~/.claude/skills. 폴더 이름은 다음과 일치해야 합니다: 이름 프론트매터의 필드로, 소문자와 하이픈을 사용합니다.
3단계: 새 Claude Code 세션 시작 해당 디렉터리에서 세션을 시작하고 설명에 해당하는 내용을 요청하세요. 답변에 스킬의 구조가 나타나야 합니다(검토 섹션, 심각도 라벨 등 스킬에 정의된 항목). 구성 파일이나 그 밖에 재시작해야 할 것은 없습니다.
스크린샷과 Claude.ai에 해당하는 방법이 포함된 더 긴 안내가 필요하다면 Claude 스킬 설치 방법을 읽어 보세요.
스킬 테스트 방법
테스트에는 5분이 걸립니다.
- 트리거 테스트. 서로 다른 표현을 사용해 스킬이 작동해야 하는 요청 세 가지를 해 보세요("이걸 검토해 줘", "이 함수에 문제가 있나요?", "PR을 확인해 줘"). 하나라도 놓치면 해당 표현을 설명에 추가하세요.
- 부정 테스트. 이 스킬이 작동하면 안 되는 연관된 요청을 해 보세요("이 변수 이름을 바꿔 줘"). 그런데도 스킬이 로드된다면 설명이 너무 포괄적인 것입니다.
- 출력 테스트. 답변을 SKILL.md가 약속한 내용과 비교하세요. 스킬에 "항상 각 발견 사항의 심각도를 나열하라"고 적혀 있는데 출력에 심각도가 없다면, 지침은 읽혔지만 따르지 않은 것입니다. 지침을 더 짧고 명확하게 다듬으세요.
- 명시적 테스트. 스킬 이름을 직접 말해 보세요. 이 방법은 작동하지만 자동 검색이 작동하지 않는다면 문제는 100% 설명에 있습니다.
잘 만들어진 SKILL.md가 어떤 모습인지 직접 작성하거나 구매하기 전에 확인하려면, 실제 SKILL.md 파일 12개를 여기에서 줄마다 설명해 둔 글을 읽어 보세요.
개발자를 위한 Claude Code 스킬 15가지
아래의 모든 항목은 Claude Code 스킬 컬렉션에서 가져온 것입니다. 각각은 일회성 구매 상품으로, .md 스킬 파일과 README가 포함되며 30일 환불 보장 정책이 적용됩니다. 가격은 작성 당시 기준으로 정확합니다.
코드 품질
Yuri - 코드 리뷰어 AI Skill ($19): 모든 diff, 파일 또는 PR에 대해 구조화된 리뷰를 수행하고 심각도별로 결과를 분류합니다.
Soren - 코드 감사 AI Skill ($19): 단일 변경 사항이 아니라 전체 코드베이스를 감사하며 구조적 부채, 사용하지 않는 코드, 일관되지 않은 패턴 및 위험 집중 영역을 찾습니다. 기존 저장소를 인수받은 첫 주에 유용합니다.
Albert - AI 코드 리뷰 agent ($39): 빠른 검토 루프에 맞춰 조정된 리뷰 agent로, 변경된 줄의 정확성과 엣지 케이스에 집중합니다.
Mira - QA 엔지니어 AI Skill ($19): 기능 설명이나 diff를 테스트 케이스, 엣지 케이스 및 테스트 계획으로 전환한 다음, 사용 중인 프레임워크에 맞춰 테스트를 작성합니다. Claude Code에 "테스트 추가"를 요청했을 때 정상 흐름 이상의 결과를 원한다면 유용합니다.
딜리버리
Rami - DevOps 엔지니어 AI Skill ($19): 실제 DevOps 엔지니어가 보여주는 신중함으로 CI/CD 파이프라인, Dockerfile, 코드형 인프라 및 인시던트 런북을 다룹니다. 배포 단계를 작성하기 전에 롤백 방법부터 묻습니다.
Max - 풀스택 개발자 AI Skill ($19): API, 데이터 계층 및 UI 전반에 걸쳐 기능의 기본 구조를 만들고 각 구성 요소의 일관성을 유지하는 제너럴리스트입니다. 딱 하나의 딜리버리 Skill만 설치한다면 이것을 선택하세요.
Lena - 프런트엔드 개발자 AI Skill ($19): 최신 프런트엔드 스택을 위한 컴포넌트 구조, 상태 관리, 접근성 및 반응형 동작을 다룹니다. Claude Code가 인라인 스타일이 가득한 div 더미를 배포하지 않도록 합니다.
Niko - 백엔드 개발자 AI Skill ($19): 서버 코드의 API 설계, 데이터 모델링, 오류 처리 및 성능을 다룹니다. 일반적인 prompts가 건너뛰기 쉬운 지루한 부분(검증, 페이지네이션, 멱등성)에 강합니다.
Elena - 데이터 엔지니어 AI Skill ($19): 파이프라인, 스키마, 변환 및 데이터 품질 검사를 다룹니다. 데이터를 제공하는 작업이 아니라 데이터를 이동하는 작업이라면 사용하세요.
문서 및 프로세스
Saoirse - 테크니컬 라이터 AI Skill ($19): 일관된 문체로 README, PR 설명, 변경 로그, 아키텍처 노트 및 온보딩 문서를 작성합니다. 이 Skill을 설치하고 Claude Code에 "PR 설명을 작성해 줘"라고 요청하면 한 줄짜리 설명이 아니라 맥락, 변경 사항, 테스트 및 위험을 담은 결과를 얻을 수 있습니다.
Dorian - AI API 문서화 에이전트 ($39): 코드에서 API 레퍼런스 문서를 생성하고 유지 관리합니다. 엔드포인트, 매개변수, 예시, 오류 응답을 포함합니다. 라우터 파일을 지정하면 빠진 내용을 채워 줍니다.
Verity - 릴리스 엔지니어링 및 빌드 시스템 엔지니어 AI Skill ($19): 버전 관리, 릴리스 노트, 커밋 메시지 규칙, 빌드 구성 및 재현성을 관리합니다. 팀에서 Conventional Commits를 두고 논쟁한다면 설치할 Skill입니다.
보안
Anaya - 애플리케이션 보안 엔지니어 AI Skill ($19): 인젝션, 인증 결함, 시크릿 처리 및 종속성 위험을 검토하고, 발견 사항만 제시하는 대신 해결 방법을 설명합니다. 릴리스 후가 아니라 릴리스 전에 실행하세요.
Selwyn - 침투 테스터 Claude Skill ($19): 위협 모델, 공격 경로, 테스트 우선순위 목록을 통해 자신의 애플리케이션을 공격자의 관점에서 분석합니다.
Cassandra - 취약점 관리 엔지니어 Claude Skill ($19): 스캐너 출력과 CVE 목록을 분류합니다. 무엇이 중요한지, 무엇이 노이즈인지, 무엇을 먼저 패치해야 하는지 판단합니다. CI에서 종속성 감사를 함께 실행하세요.
어떤 것부터 시작해야 할지 모르겠나요? Claude Skill 마켓플레이스 페이지에서 전체 카탈로그를 역할별로 분류해 볼 수 있으며, Claude Code 컬렉션은 개발자용 하위 모음입니다.
자주 묻는 질문
Claude Code Skills 폴더는 어디에 있나요?
프로젝트 수준 Skills는 다음 위치에 있습니다. .claude/skills/<name>/SKILL.md 저장소 안에 둡니다. 사용자 수준 Skills는 다음 위치에 있습니다. ~/.claude/skills/<name>/SKILL.md 홈 디렉터리에 두면 모든 프로젝트에 적용됩니다.
Claude Code Skills는 ChatGPT에서 작동하나요?
.md 파일은 가능하지만 자동 검색은 지원되지 않습니다. 동일한 SKILL.md를 사용자 지정 GPT의 지침으로 붙여넣거나 업로드하면 같은 방식으로 작동합니다. ChatGPT에는 폴더 규칙과 설명 기반 로딩 기능이 없으므로 Claude Code가 관련성을 판단해 실행하는 대신 해당 GPT를 사용해 직접 호출해야 합니다.
Claude Code Skill과 CLAUDE.md의 차이점은 무엇인가요?
CLAUDE.md는 매번 로드되므로 프로젝트에 대한 짧고 영구적인 사실을 담아야 합니다. Skill은 설명이 작업과 일치할 때만 로드되며, 절차에 필요한 만큼 길게 작성할 수 있습니다. 긴 체크리스트는 CLAUDE.md가 아니라 Skills에 넣어야 합니다.
한 번에 두 개 이상의 Skill을 설치할 수 있나요?
네. 각 Skill은 .claude/skills 아래에 있는 개별 폴더이며, Claude Code가 모든 Skill을 색인화합니다. Skill이 필요할 때까지 설명만 컨텍스트에 유지되므로 15개를 설치해도 실제로 실행되기 전까지는 비용이 거의 들지 않습니다.
Skills를 사용하려면 MCP 서버가 필요한가요?
아니요. Skills는 지침이며 Claude Code에 내장된 도구(파일 편집, 셸, git)와 함께 작동합니다. MCP 서버는 데이터베이스나 브라우저 같은 외부 도구를 추가합니다. Skill은 이러한 도구를 효과적으로 사용하는 방법을 Claude에 알려줄 수 있지만, 해당 도구가 반드시 필요한 것은 아닙니다.
핵심 요약
Claude Code Skill은 SKILL.md가 포함된 폴더로, 프로젝트의 .claude/skills 또는 사용자의 ~/.claude/skills에 배치됩니다. 설명을 기반으로 검색되며 필요할 때만 로드됩니다. CLAUDE.md는 짧게 유지하고, 의도적인 작업에는 슬래시 명령을 사용하며, 도구에는 MCP를 사용하고, 전문 지식에는 Skills를 사용하세요. 하나를 설치하고 세 가지 표현과 하나의 부정 표현으로 테스트한 다음, 워크플로에 필요한 대로 나머지를 추가하세요.
KissMySkills의 Claude Code Skills 컬렉션에서 모든 개발자 Skill을 둘러보세요.