Claude Code Skills 완벽 가이드 2026 — 슬래시 커맨드로 반복 작업 자동화하기

매번 같은 코드 리뷰 지침을 채팅창에 복붙하고 있다면, 그게 바로 Claude Code Skills를 써야 하는 신호입니다. 저도 처음엔 "그냥 프롬프트 아니야?" 싶었는데, 직접 써본 결과 반복 작업 방식이 완전히 달라졌어요. Skills는 단순한 프롬프트 저장소가 아니라, /skill-name 하나로 호출하는 재사용 워크플로우 패키지입니다. 2025년 10월 공식 출시 이후 2026년 2월에는 'Skills 2.0'으로 진화해 실행 스크립트까지 포함한 실제 산출물 생성 워크플로우가 됐어요.

Claude Code 터미널에서 /code-review 슬래시 커맨드를 입력하는 화면

 

Skills가 CLAUDE.md와 다른 이유

CLAUDE.md는 세션 시작할 때 항상 로드됩니다. 프로젝트 규칙이나 사실 정보처럼 "항상 알고 있어야 하는 것"을 넣는 파일이에요. 반면 Skills는 호출할 때만 컨텍스트에 로드됩니다.

공식 문서는 이렇게 설명합니다. "같은 지침, 체크리스트 또는 다단계 절차를 계속 채팅에 붙여넣거나, CLAUDE.md의 섹션이 사실이 아닌 절차로 성장했을 때 skill을 생성하라." 결국 CLAUDE.md가 무거워지기 시작하면 Skills로 분리하라는 뜻이죠.

컨텍스트 비용 차이도 실질적입니다. 필요할 때만 로드하기 때문에 토큰 비용을 30~50% 절감한 사례가 보고됐어요. 긴 체크리스트나 다단계 절차는 항상 올라가 있을 필요가 없으니까요.

내장 커맨드(/help, /compact)와도 다릅니다. 내장 커맨드는 고정 로직이 즉시 실행되지만, Skills는 프롬프트 기반으로 Claude가 실제로 도구를 사용해 작업을 조율합니다. 같은 /code-review를 써도 상황마다 결과가 달라질 수 있는 이유가 여기 있어요.

CLAUDE.md vs Skills vs 내장 커맨드 차이점 비교표

 

기본 내장 번들 Skills 7가지

Claude Code를 설치하면 별도 설정 없이 바로 쓸 수 있는 번들 Skills가 있습니다. disableBundledSkills 설정으로 끄지 않는 한 모든 세션에서 사용 가능해요.

스킬	기능
/code-review	코드 정확성, 보안, 스타일 검토
/batch	대규모 변경을 독립 단위로 분해해 병렬 실행
/debug	도구 호출 실패나 컨텍스트 혼란 진단
/loop	반복 주기로 프롬프트 실행 (예: "5분마다 오류 확인")
/claude-api	Claude API 구현 참조 자료 로드
/run	프로젝트 유형을 자동 인식해 앱 실행 (v2.1.145 이상)
/verify	코드 변경이 의도대로 동작하는지 실제로 확인 (v2.1.145 이상)

/batch가 특히 인상적인데, 수백 파일에 걸친 변경을 각각 격리된 git worktree에서 병렬로 처리해 줍니다. 대규모 리팩토링할 때 충돌 걱정 없이 돌릴 수 있어요.

 

커스텀 Skills를 5분 만에 만드는 법

커스텀 스킬은 파일 하나면 됩니다. ~/.claude/skills/<skill-name>/SKILL.md 경로에 파일을 만들면 즉시 슬래시 커맨드로 호출할 수 있어요. Claude Code 재시작도 필요 없습니다.

mkdir -p ~/.claude/skills/summarize-changes
cat > ~/.claude/skills/summarize-changes/SKILL.md << 'EOF'
---
description: 커밋되지 않은 변경사항을 요약하고 위험 항목 표시. 사용자가 무엇이 변경됐는지 물어보거나 커밋 메시지나 diff 리뷰를 요청할 때 사용.
---

## 현재 변경사항
!`git diff HEAD`

## 지침
위 변경사항을 2~3개 불릿으로 요약하고, 위험 항목을 나열하라.
EOF

프론트매터에서 세밀한 제어도 가능합니다. disable-model-invocation: true를 넣으면 Claude가 맥락상 자동 호출하는 것을 막을 수 있어요. 배포 스킬처럼 "실수로 실행되면 안 되는" 작업에 유용합니다. allowed-tools로 이 스킬이 활성화될 때만 허용할 도구를 제한할 수도 있고, model: claude-opus-4-8처럼 특정 스킬에서만 더 강력한 모델로 전환하는 것도 됩니다.

!`command` 구문은 Skills의 숨겨진 강점입니다. SKILL.md가 Claude에게 전달되기 전에 셸 커맨드가 실행돼 결과가 자동으로 삽입되거든요. 위 예제의 !`git diff HEAD`처럼 현재 상태를 동적으로 주입할 수 있어요.

SKILL.md 파일 구조와 프론트매터 옵션 설명 다이어그램

스킬 저장 위치에 따라 적용 범위가 달라집니다. ~/.claude/skills/에 넣으면 모든 프로젝트에서 쓸 수 있고, .claude/skills/에 넣으면 해당 프로젝트에서만 작동합니다. Monorepo에서 apps/web/.claude/skills/ 같은 중첩 위치도 지원해요.

 

실전에서 나온 생산성 수치들

"10배 빠르다"는 말은 과장이 많지만, 실제 보고된 수치는 꽤 구체적입니다. 표준화된 /review 스킬을 적용하면 코드 리뷰 사이클이 40% 단축됐고, TDD와 스킬을 결합하면 프로덕션 버그가 70% 감소한 사례가 있어요. 컨텍스트 관리 스킬 활용 시 토큰 비용 30~50% 절감, 성능 리팩토링 스킬 적용 시 렌더 시간이 847ms에서 286ms로 줄었다는 수치도 나왔습니다.

internal-comms 스킬 하나로 일일 Slack 메시지 작성 30분을 절약했다는 사례도 인상적이에요. 근데 가장 극단적인 건 Medium에 올라온 한 개발자 사례인데, "4인×6개월" 규모 프로젝트를 혼자 2개월 만에 완료했다고 합니다. 스킬 중심 워크플로우로 컨텍스트 관리 부담을 없애고 목표에만 집중한 결과예요.

Ramp에서는 ML 모델 변환 작업에 Skills를 적용해서 1~2일을 절약하기도 했습니다.

스킬 적용 전후 코드 리뷰 사이클 및 버그 수 비교 인포그래픽

 

바로 설치할 수 있는 커뮤니티 추천 스킬

DEV Community 리뷰어가 100개 스킬을 테스트한 결과, TOP 스킬로 꼽힌 것들입니다.

문서 처리 계열: PDF 폼 필드 추출, DOCX/PPTX/XLSX 네이티브 생성 스킬이 1~2위였어요. 모델이 "알아서 처리"하는 게 아니라 실행 코드 기반으로 작동해서 환각이 없다는 게 이유였습니다.

개발 계열: skill-creator(올바른 스킬 아키텍처 자동 생성), webapp-testing(Playwright 기반 브라우저 테스트 자동화), mcp-builder(Skills와 MCP 서버 연동)가 꼽혔습니다.

커뮤니티에서 주목받는 번들 중 obra/superpowers는 TDD, 디버깅, 협업 패턴 20개 이상을 묶었고, Trail of Bits Security Skills는 정적 분석과 취약점 탐지에 특화됩니다. 한국어 커뮤니티에서는 bear2u/my-skills(GitHub)를 참고해볼 만합니다.

설치는 간단합니다. ~/.claude/skills/ 아래에 디렉토리를 만들고 SKILL.md를 넣으면 끝이에요. 공식 마켓플레이스에서는 /plugin install document-skills@anthropic-agent-skills로도 설치할 수 있습니다.

보안 주의: 신뢰하지 않는 소스의 스킬은 SKILL.md 및 포함된 스크립트를 반드시 먼저 읽어보세요. 스킬은 광범위한 도구 접근 권한을 스스로에게 부여할 수 있습니다.

Claude Code 마켓플레이스에서 스킬 설치 방법 및 커뮤니티 추천 스킬 목록

 

AgentSkills 오픈 표준 — Claude만의 기능이 아니다

2025년 12월 18일 AgentSkills 오픈 표준이 공개되면서 SKILL.md 포맷이 다른 AI 도구에서도 작동하게 됐습니다. 2026년 기준으로 Claude Code, Codex CLI(OpenAI), Gemini CLI(Google), GitHub Copilot, Cursor, Cline, Windsurf가 동일한 포맷을 지원해요.

사실 처음엔 Claude 전용 포맷이라 다른 도구로 옮기면 다시 만들어야 하나 걱정했는데, 그럴 필요가 없어졌어요. Claude 중심으로 만든 스킬이 다른 도구에서도 그대로 돌아간다는 뜻입니다. 프론트매터 필수 필드(name, description)만 지키고 플랫폼 특화 동작을 선택적 필드에 분리하면 됩니다.

Anthropic은 Skills와 MCP(Model Context Protocol)를 상호보완 관계로 설명합니다. MCP가 외부 서비스 연동에 강하다면, Skills는 조직별 워크플로우를 캡슐화하는 데 적합하다고요. 둘 다 쓰는 게 맞습니다.

---

처음 시작하기 좋은 방법은 지금 당장 자주 쓰는 코드 리뷰 기준을 SKILL.md 하나로 만들어보는 거예요. 팀 전체가 같은 기준으로 리뷰하게 되는 부수 효과도 생기거든요. 커스텀 스킬 제작이 막막하다면 공식 skill-creator 플러그인이 제작 전 과정을 안내해주니 거기서 시작해도 됩니다.