| [Glossary] 클로드 스킬(Skill) 완벽 정리 | SKILL.md와 커스텀 스킬을 쉽게 이해하는 법 |
한 줄 요약: 클로드 스킬(Claude Skill)이란, Claude Code에서 마크다운 파일(.md)로 정의하고
/슬래시명령어형태로 실행하는 재사용 가능한 AI 작업 단위이다.
1. 클로드 스킬이란 무엇인가?
셰프의 레시피 카드를 상상해 보세요. “파스타 삶기”라는 카드에는 재료, 순서, 주의사항이 적혀 있습니다. 셰프는 매번 처음부터 생각하지 않고 카드를 꺼내 따릅니다.
Claude Code의 스킬은 이 레시피 카드입니다. 자주 사용하는 작업(코드 리뷰, 글로사리 작성, 테스트 생성 등)을 마크다운 파일로 정의해 두면, /글로사리 처럼 슬래시 명령어 하나로 일관된 방식으로 실행됩니다.
스킬의 핵심 가치:
- 반복 작업 표준화
- 팀 간 일관된 워크플로우 공유
- 복잡한 프롬프트 재사용
2. 핵심 개념 이해하기
스킬 파일 위치
프로젝트 루트/
├── .claude/
│ └── commands/ ← 프로젝트 스킬 폴더
│ ├── glossary.md ← /glossary 명령어
│ ├── code-review.md ← /code-review 명령어
│ └── deploy.md ← /deploy 명령어
└── CLAUDE.md ← 전역 프로젝트 설정
전역 스킬은 ~/.claude/commands/ 에 저장하면 모든 프로젝트에서 사용할 수 있습니다.
SKILL.md (스킬 파일) 구조
---
# 선택적 프런트매터 (지원 여부는 버전에 따라 다름)
---
당신은 [역할 정의]입니다.
**입력:** $ARGUMENTS
---
### [STEP 1] 사전 확인
...
### [STEP 2] 주요 작업
...
### [STEP 3] 결과 출력
...
$ARGUMENTS: 슬래시 명령어 뒤에 입력한 텍스트가 자동으로 대입되는 변수입니다.
스킬 호출 방식
사용자 입력: /glossary RAG
↓
$ARGUMENTS = "RAG"
↓
스킬 파일 로드 → Claude가 지시에 따라 실행
3. 실무 적용 예시
간단한 코드 리뷰 스킬 파일 예시입니다.
<!-- .claude/commands/code-review.md -->
당신은 10년 경력의 시니어 소프트웨어 엔지니어입니다.
아래 코드 또는 PR을 리뷰해 주세요.
**대상:** $ARGUMENTS
---
### 리뷰 체크리스트
**[보안]**
- [ ] SQL 인젝션, XSS 등 OWASP Top 10 취약점 확인
- [ ] 하드코딩된 시크릿/API 키 없음
- [ ] 입력값 검증 존재
**[성능]**
- [ ] N+1 쿼리 문제 없음
- [ ] 불필요한 반복 연산 없음
- [ ] 메모리 누수 가능성 없음
**[가독성]**
- [ ] 함수/변수명이 의미를 명확히 전달
- [ ] 복잡한 로직에 주석 존재
- [ ] 단일 책임 원칙 준수
### 출력 형식
각 항목별로 ✅/⚠️/❌ 표시 후 개선 제안을 구체적 코드 예시와 함께 제공하세요.
사용 방법:
/code-review src/auth/login.py
/code-review https://github.com/org/repo/pull/123
4. 클로드 스킬 vs 유사 개념 비교
| 구분 | 클로드 스킬 | 시스템 프롬프트 | 스크립트/매크로 |
|---|---|---|---|
| 형식 | 마크다운 파일 | 텍스트 설정 | 코드 파일 |
| 재사용 | ✅ /슬래시로 언제든 | ❌ 세션마다 설정 | ✅ 실행 가능 |
| AI 통합 | ✅ Claude 내장 | ✅ | ❌ 별도 실행 |
| 버전 관리 | ✅ Git 관리 가능 | 제한적 | ✅ |
| 팀 공유 | ✅ 리포지토리 공유 | 어려움 | ✅ |
| 인수(Arguments) | ✅ $ARGUMENTS | ❌ | ✅ |
5. 마치며
클로드 스킬은 반복적인 AI 작업을 표준화하는 강력한 도구입니다. 팀 단위로 .claude/commands/ 폴더를 Git으로 관리하면 모든 팀원이 동일한 품질의 작업을 수행할 수 있습니다. 다음으로 동적 스킬 로딩(Dynamic Skill Loading)과 CLAUDE.md 설정을 함께 이해하면 Claude Code를 팀의 표준 AI 워크플로우로 구축할 수 있습니다.
참고 자료
- Claude Code 공식 문서 - Slash Commands — 스킬/슬래시 명령어 공식 가이드
- Claude Code GitHub — 오픈소스 코드베이스
함께 읽으면 좋은 용어
이 개념과 함께 알아두면 이해가 깊어지는 관련 용어들입니다.
댓글 남기기