Claude Code Skill은 Claude Code가 작업이 Skill의 설명과 일치할 때 필요에 따라 로드하는 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.md를 읽고 따릅니다. 일치하지 않으면 Skill이 차지하는 비용은 거의 없습니다. 따라서 파일의 다른 어떤 내용보다 잘 작성된 설명이 중요합니다. Skill을 열지 결정하기 전에 Claude Code가 확인하는 유일한 내용이기 때문입니다.
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 파일 이름이나 폴더 이름이 아니라 프런트매터의 필드를 기준으로 합니다. "풀 리퀘스트 코드 리뷰" 같은 설명은 "review"라고 정확히 말할 때만 작동하므로 약합니다. "버그, 보안 문제, 누락된 테스트, 불명확한 네이밍을 찾기 위해 diff, 풀 리퀘스트 및 변경된 파일을 검토하세요. 사용자가 코드를 확인, 리뷰, 감사 또는 비평해 달라고 요청할 때마다 사용하세요" 같은 설명은 개발자가 실제로 사용하는 표현에 반응합니다.
알아야 할 세 가지:
- 스킬은 세션이 시작될 때 색인됩니다. 세션 중간에 폴더를 추가했다면 새 세션을 시작하거나 Claude Code에 스킬을 다시 읽어 달라고 요청하세요.
- 설명에는 스킬이 무엇인지뿐 아니라 언제 사용해야 하는지도 적어야 합니다. 트리거 문구도 설명에 포함하세요.
- 스킬 이름을 지정해 언제든 강제로 사용할 수 있습니다. "이 diff에 코드 리뷰어 스킬을 사용해"라고 말하면 됩니다. 자동 검색은 편의를 위한 기능일 뿐 유일한 경로는 아닙니다.
Skills vs CLAUDE.md vs 슬래시 명령 vs 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가 아니라면 이름을 바꾸세요. frontmatter에는 최소한 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. 폴더 이름은 다음과 일치해야 합니다. 이름 frontmatter의 필드이며, 하이픈을 사용한 소문자로 작성합니다.
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 - Code Reviewer AI Skill ($29): 모든 diff, 파일 또는 PR을 대상으로 구조화된 검토를 수행하고, 발견 사항을 심각도별로 그룹화합니다.
Soren - Code Auditor AI Skill ($29): 단일 변경 사항이 아니라 전체 코드베이스를 감사하며, 구조적 부채, 사용되지 않는 코드, 일관되지 않은 패턴 및 위험이 집중된 지점을 찾습니다. 인수받은 저장소의 첫 주에 유용합니다.
Albert - AI Code Review Agent ($32): 빠른 반복 검토에 맞춰진 review agent로, 변경된 줄의 정확성과 엣지 케이스에 집중합니다.
Mira - QA Engineer AI Skill ($29): 기능 설명이나 diff를 테스트 케이스, 엣지 케이스 및 테스트 계획으로 전환한 다음, 사용 중인 프레임워크에 맞춰 테스트를 작성합니다. Claude Code에 "테스트 추가"를 요청하면서 정상 경로 이상의 테스트를 원할 때 유용합니다.
배포
Rami - DevOps Engineer AI Skill ($29): 실제 DevOps 엔지니어처럼 신중하게 CI/CD 파이프라인, Dockerfile, 코드형 인프라 및 장애 대응 런북을 다룹니다. 배포 단계를 작성하기 전에 롤백 방법을 묻습니다.
Max - Full Stack Developer AI Skill ($29): API, 데이터 계층 및 UI 전반에서 기능의 뼈대를 만들고 각 구성 요소의 일관성을 유지하는 제너럴리스트입니다. 딱 하나의 delivery Skill만 설치한다면 이것을 선택하세요.
Lena - Frontend Developer AI Skill ($29): 최신 프런트엔드 스택을 위한 컴포넌트 구조, 상태 관리, 접근성 및 반응형 동작을 다룹니다. Claude Code가 인라인 스타일로 뒤범벅된 div를 배포하지 않도록 합니다.
Niko - Backend Developer AI Skill ($29): 서버 코드의 API 설계, 데이터 모델링, 오류 처리 및 성능을 다룹니다. 일반적인 prompts가 건너뛰는 지루하지만 중요한 부분(검증, 페이지네이션, 멱등성)에 강합니다.
Elena - 데이터 엔지니어 AI Skill ($29): 파이프라인, 스키마, 변환 및 데이터 품질 검사를 다룹니다. 데이터를 제공하는 작업이 아니라 데이터를 이동하는 작업에 사용하세요.
문서 및 프로세스
Saoirse - 테크니컬 라이터 AI Skill ($29): 일관된 문체로 README, PR 설명, 변경 로그, 아키텍처 노트 및 온보딩 문서를 작성합니다. 설치한 상태에서 Claude Code에 "PR 설명을 작성해 줘"라고 요청하면 한 줄짜리 설명이 아니라 맥락, 변경 사항, 테스트 및 위험 요소가 포함된 결과를 얻을 수 있습니다.
Dorian - AI API 문서화 에이전트 ($32): 코드에서 API 레퍼런스 문서를 생성하고 유지 관리합니다. 엔드포인트, 매개변수, 예시, 오류 응답까지 포함합니다. 라우터 파일을 지정하면 누락된 부분을 채워 줍니다.
Verity - 릴리스 엔지니어링 및 빌드 시스템 엔지니어 AI Skill ($29): 버전 관리, 릴리스 노트, 커밋 메시지 규칙, 빌드 구성 및 재현성을 다룹니다. 팀에서 Conventional Commits를 두고 논쟁한다면 설치할 Skill입니다.
보안
Anaya - 애플리케이션 보안 엔지니어 AI Skill ($29): 인젝션, 인증 결함, 시크릿 처리, 종속성 위험을 코드에서 검토하고, 단순히 문제를 지적하는 데 그치지 않고 해결 방법을 설명합니다. 릴리스 후가 아니라 릴리스 전에 실행하세요.
Selwyn - 침투 테스터 Claude Skill ($29): 위협 모델, 공격 경로, 테스트 우선순위 목록을 바탕으로 자신의 애플리케이션을 공격자의 관점에서 분석합니다.
Cassandra - 취약점 관리 엔지니어 Claude Skill ($29): 스캐너 출력과 CVE 목록을 분류합니다. 무엇이 중요한지, 무엇이 노이즈인지, 무엇을 먼저 패치해야 하는지 파악할 수 있습니다. CI에서 종속성 감사를 함께 실행하세요.
어떤 것부터 시작해야 할지 모르겠나요? Claude Skills 마켓플레이스 페이지에서는 전체 카탈로그를 역할별로 분류하고, 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이 필요할 때까지 설명만 컨텍스트에 유지되므로, 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 컬렉션에서 모든 개발자 Skills를 살펴보세요.
