클로드 스킬 완벽 가이드: 작동 원리와 설치할 만한 15가지
클로드 스킬의 작동 방식, SKILL.md 작성법, 설치 위치와 방법을 설명하고 2026년 10월 기준 설치할 만한 클로드 스킬 15가지를 정리했습니다.
빠른 답변 (2026년 10월 25일 업데이트)
- 클로드 스킬이란?
- 클로드 스킬은 SKILL.md 파일이 있는 폴더입니다. YAML 프런트매터가 Claude에게 언제 사용할지 알려주고, 지침과 선택적 스크립트 또는 참조 파일을 담습니다. Claude는 요청이 설명과 일치하면 클로드 스킬을 자동으로 로드하거나, /skill-name으로 직접 실행할 수 있습니다.
- 클로드 스킬은 어디에 저장되나요?
- ~/.claude/skills/<name>/SKILL.md는 기기의 모든 프로젝트에 적용되고, .claude/skills/<name>/SKILL.md는 리포지토리 안에 두어 팀과 공유합니다. 플러그인과 claude.ai 계정도 클로드 스킬을 제공할 수 있습니다.
- GitHub에서 클로드 스킬을 설치하려면 어떻게 하나요?
- 플러그인 마켓플레이스를 추가하고 설치하세요. 예: /plugin marketplace add anthropics/skills, 그다음 /plugin install document-skills@anthropic-agent-skills. 또는 스킬 폴더를 ~/.claude/skills/에 복사하세요.
클로드 스킬은 Claude에게 절차를 한 번 가르쳐 두고 영원히 재사용하는 가장 간단한 방법입니다. 같은 체크리스트를 매번 채팅에 붙여넣는 대신 SKILL.md 파일에 작성해 두면 Claude가 필요할 때만 가져옵니다. 이제 클로드 스킬은 사용자 지정 슬래시 명령도 대체합니다. 이 가이드는 스킬의 작동 방식, 작성법, 지금 설치할 만한 15가지를 설명합니다.
이 목록은 Sumus AI Employee가 관리하며 매월 업데이트됩니다. 변경 사항은 하단의 업데이트 로그에서 확인하세요.
클로드 코드 스킬 작동 방식
클로드 스킬 문서는 설치 전에 알아야 할 세 가지 개념을 설명합니다.
- 요청 시 로드. CLAUDE.md와 달리 "스킬 본문은 사용될 때만 로드되므로, 긴 참조 자료도 필요하기 전까지 비용이 거의 들지 않습니다." 처음에는 이름과 설명만 컨텍스트에 올라갑니다.
- 두 가지 실행 방법. Claude는 요청이 설명과 일치하면 스킬을 호출하거나, /skill-name을 입력해 실행합니다. disable-model-invocation: true로 설정하면 수동 전용, user-invocable: false로 설정하면 Claude 전용이 됩니다.
- 명령이 스킬에 통합됨. .claude/commands/deploy.md 파일과 .claude/skills/deploy/SKILL.md 스킬 모두 /deploy를 만듭니다. 기존 명령 파일도 계속 작동합니다.
- 개방형 표준. 스킬은 Agent Skills 표준을 따르므로 같은 폴더가 다른 도구에서도 작동합니다. Claude Code는 서브에이전트 실행, 동적 컨텍스트 주입 같은 확장 기능을 추가합니다.
한 번 호출되면 스킬 콘텐츠는 대화에 유지됩니다. 자동 압축 후 Claude Code는 최근 스킬의 처음 5,000토큰을 25,000토큰 공유 예산 안에서 다시 연결하므로, 매우 긴 스킬은 잘릴 수 있습니다.
클로드 스킬 만들기
- 폴더 만들기: mkdir -p ~/.claude/skills/summarize-changes (또는 리포지토리의 .claude/skills/).
- --- 줄 사이에 프런트매터를 넣어 SKILL.md를 작성하세요. description은 Claude가 매칭하는 부분이므로 주요 사용 사례를 맨 앞에 두세요. description과 when_to_use는 1,536자에서 잘립니다.
- 프런트매터 아래에 지침을 작성하세요. 입력에는 $ARGUMENTS, 번들 스크립트를 가리킬 때는 ${CLAUDE_SKILL_DIR}를 사용하세요.
- 선택적으로 실시간 데이터를 주입하세요. !`git diff HEAD` 같은 줄은 Claude가 스킬을 읽기 전에 실행되어 실제 작업 트리를 보여줍니다.
- 두 가지 방식으로 테스트하세요. 매칭되는 질문을 한 다음, /summarize-changes를 직접 실행해 보세요.
필드 | 하는 일 |
|---|---|
name / description | 명령 이름과 Claude가 매칭하는 트리거 텍스트 |
disable-model-invocation | true = 본인만 실행 가능 (배포, 커밋에 적합) |
allowed-tools | 해당 턴에 도구 사전 승인, 예: Bash(git commit *) |
model / effort | 스킬 실행 중 모델이나 effort 재정의 |
context: fork | 별도 서브에이전트 컨텍스트에서 스킬 실행 |
arguments | $name 치환을 위한 명명된 인자 |
hooks | 스킬 호출 시 훅 등록 |
이미 가지고 있는 내장 스킬
Claude Code는 번들 스킬을 제공하며 다른 스킬처럼 호출됩니다. 프롬프트 기반이라 Claude가 도구로 작업을 조율합니다.
- /doctor 설치 상태, 사용하지 않는 스킬과 MCP 서버, 비대한 CLAUDE.md 파일, 권한을 점검합니다. /doctor prompt-audit는 지침을 감사합니다.
- /run 및 /verify 앱을 실행하고 테스트가 아닌 실행 중인 앱에서 변경 사항이 작동하는지 확인합니다. /run-skill-generator는 실행 레시피를 프로젝트 스킬로 기록합니다.
- /code-review, /debug, /batch, /loop 리뷰, 디버깅, 일괄 편집, 반복 작업용.
- /claude-api 사용 언어에 맞는 Claude API 참조를 로드하며 migrate, cost-optimize, build-eval, prompt-audit 같은 하위 명령을 제공합니다.
프로젝트에 verify 또는 simplify라는 이름의 스킬이 있으면 Claude Code(v2.1.286+)가 커밋 전에 실행하도록 Claude에 지시합니다.
설치할 만한 클로드 스킬 15가지
Anthropic 공식 anthropics/skills 리포지토리와 플러그인 디렉터리, 가장 많은 스타를 받은 커뮤니티 세트에서 골랐습니다. 각 항목은 2026년 10월 25일 기준 실제 설치 가능한 스킬입니다.
# | 클로드 스킬 | 출처 | 사용 용도 |
|---|---|---|---|
1 | skill-creator | Anthropic | 자신만의 스킬을 만들고 편집·평가하고 설명을 튜닝 |
2 | frontend-design | Anthropic | 템플릿 기본값 같지 않은 UI |
3 | webapp-testing | Anthropic | Playwright로 로컬 웹 앱 구동 및 스크린샷 |
4 | mcp-builder | Anthropic | Python(FastMCP) 또는 TypeScript로 MCP 서버 구축 |
5 | Anthropic | 텍스트, 표, 양식 필드 추출 및 PDF 채우기 | |
6 | docx | Anthropic | 변경 내용 추적으로 Word 문서 생성·편집 |
7 | xlsx | Anthropic | 수식과 서식이 있는 스프레드시트 |
8 | pptx | Anthropic | 슬라이드 덱 제작·편집 |
9 | web-artifacts-builder | Anthropic | 다중 컴포넌트 React/Tailwind/shadcn 아티팩트 |
10 | doc-coauthoring | Anthropic | 사양, 제안, 결정 문서의 구조적 초안 작성 |
11 | systematic-debugging | Superpowers | 수정안 제안 전 근본 원인 찾기 |
12 | test-driven-development | Superpowers | 레드-그린-리팩터 규율 |
13 | writing-plans + executing-plans | Superpowers | 큰 변경을 계획하고 단계별로 실행 |
14 | using-git-worktrees | Superpowers | 워크트리에서 병렬 작업 격리 |
15 | verification-before-completion | Superpowers | 완료 선언 전에 작업이 작동함을 증명 |
설치 방법
- Anthropic 스킬: /plugin marketplace add anthropics/skills, 그다음 /plugin install document-skills@anthropic-agent-skills (pdf, docx, xlsx, pptx) 또는 example-skills@anthropic-agent-skills.
- skill-creator: /plugin install skill-creator@claude-plugins-official.
- Superpowers: /plugin install superpowers@claude-plugins-official, 또는 obra/superpowers-marketplace를 추가하세요. Superpowers 리포지토리는 GitHub 스타 30만 개 이상을 보유하고 있습니다.
- 단일 스킬 수동 설치: 폴더를 ~/.claude/skills/ 또는 리포지토리의 .claude/skills/에 복사하세요. Claude Code는 편집 사항을 실시간으로 반영합니다.
플러그인 스킬은 네임스페이스가 있어 개인 스킬과 충돌하지 않습니다. /superpowers:systematic-debugging은 개인 디버깅 스킬과 공존할 수 있습니다.
클로드 스킬 문제 해결
- 스킬이 전혀 실행되지 않음: 사용자가 실제로 입력하는 단어로 설명을 다시 작성하고 주요 사용 사례를 맨 앞에 두세요.
- 너무 자주 실행됨: 설명을 좁히거나 disable-model-invocation: true로 설정하세요.
- 클라우드 또는 Cowork 세션에서 누락: 해당 세션은 ~/.claude/skills/를 읽지 않습니다. claude.ai 계정에서 스킬을 활성화하거나 리포지토리에 커밋하세요.
- 스킬이 너무 많음: /doctor가 컨텍스트 비용으로 사용하지 않는 스킬을 표시합니다.
설정 건너뛰기: 스킬이 내장된 AI 직원
클로드 스킬은 같은 절차를 계속 실행할 때 효과가 큽니다. 정말 원하는 것이 일을 끝내는 것이라면, Sumus AI Employee는 자체 스킬, 메모리, 도구를 가지고 도착하며 사용자가 수정할 때마다 새로운 스킬을 학습합니다. 역할을 설명하면 체크리스트를 실행합니다.
클로드 스킬 FAQ
클로드 스킬과 CLAUDE.md의 차이점은 무엇인가요?
CLAUDE.md는 항상 로드되지만 스킬 본문은 사용될 때만 로드됩니다. 사실은 CLAUDE.md에, 다단계 절차는 클로드 스킬에 넣으세요.
이제 슬래시 명령과 클로드 스킬은 같은가요?
네. 사용자 지정 명령은 스킬에 통합되었습니다. .claude/commands/x.md와 .claude/skills/x/SKILL.md 모두 /x를 만들며, 스킬은 지원 파일과 호출 제어를 추가합니다.
클로드 스킬은 다른 도구에서도 작동하나요?
핵심 형식은 개방형 Agent Skills 표준을 따르므로 name, description, instructions는 이식 가능합니다. context: fork 같은 Claude Code 전용 필드는 확장입니다.
클로드 스킬이 스크립트를 실행할 수 있나요?
네. 스킬 폴더에 스크립트를 번들하고 ${CLAUDE_SKILL_DIR}로 참조한 다음 allowed-tools로 사전 승인하세요.
어떤 클로드 스킬을 먼저 설치해야 하나요?
skill-creator를 먼저 설치하세요. 반복하는 프롬프트를 스킬로 바꾸고 평가로 테스트할 수 있습니다.
Sumus AI Employee가 클로드 스킬을 대신 사용할 수 있나요?
네. Sumus AI Employee는 내장 스킬을 갖추고 사용자의 수정에서 새 스킬을 학습하므로 SKILL.md 파일을 직접 작성할 필요가 없습니다.
업데이트 로그
- — 2026년 10월 25일: 최초 게시. 작동 방식은 Claude Code skills 문서, 목록은 GitHub의 anthropics/skills, claude-plugins-official, obra/superpowers에서 가져왔습니다. 다음 갱신: 2026년 11월.