Claude Skills란 무엇인가

Skills는 Claude Code가 필요할 때만 자동으로 발견해 불러오는 전문 지식 패키지입니다. 특정 작업에 필요한 가이드라인, 규칙, 템플릿, 스크립트를 하나의 폴더에 묶어 두면, Claude가 "이 작업에는 이 지식이 필요하다"고 판단한 순간에만 그 내용을 읽습니다.

AI 에이전트에게 "이런 상황에서는 이렇게 하라"를 가르치는 가장 실용적인 방법이며, 매번 같은 설명을 반복하지 않아도 되게 만들어 줍니다.

핵심 요약

• Skills는 "필요할 때만 펼치는 레시피북" 같은 구조입니다.
• CLAUDE.md와 달리 평소 컨텍스트를 압박하지 않으므로 수백 개를 등록해도 괜찮습니다.
• MCP가 "외부 접속"을 담당한다면 Skills는 "절차적 지식"을 담당합니다.
• Git으로 팀과 공유할 수 있어 프로젝트에 넣어 두면 전원이 같은 지식을 씁니다.
• 공식 frontend-design 플러그인을 설치하면 Skills의 효과를 바로 체감할 수 있습니다.

왜 Skills가 필요한가

Claude Code를 쓰다 보면 이런 고민이 생깁니다.

• 매번 같은 디자인 규칙을 설명하는 것이 번거롭다
• CLAUDE.md에 전부 쓰면 컨텍스트가 꽉 찬다
• 비슷한 지시를 반복하거나 참고 자료를 매번 읽히는 것이 힘들다

범용 모델은 일반적인 지식은 잘 다루지만 다음은 모릅니다.

• 우리 회사의 리포트 양식
• 이 팀의 배포 절차와 승인 라인
• 이 도메인에서만 통하는 용어와 규칙

매번 설명하면 되지만, 그러면 매번 같은 설명을 반복해야 합니다. Skills는 이 설명을 파일로 만들어 필요할 때 자동으로 불러오게 합니다. 예를 들어 "React 컴포넌트를 만들어줘"라고 했을 때 react-component-design Skill이 있으면 Claude가 자동으로 그 규칙을 참조해 작업합니다.

레시피북 비유 — 단계적 로딩

주방 책장에 수십 권의 레시피북이 있어도 평소에는 책등(제목과 짧은 설명)만 보입니다. "오늘은 파스타"라고 정한 순간 비로소 이탈리아 요리 책을 꺼내 해당 페이지를 펼칩니다. 모든 책을 동시에 펼쳐 두면 주방 공간이 부족해집니다.

Skills도 같습니다. 평소에는 "이 Skill은 ○○용"이라는 메타데이터만 메모리에 상주하고, 실제 규칙과 템플릿은 필요해졌을 때만 읽습니다. 이 설계를 단계적 개시(Progressive Disclosure)라고 부르며, 지식을 3단계로 나눠 불러옵니다.

즉 Skills를 50개, 수백 개 만들어 둬도 평소 비용은 거의 없습니다. 실제로 쓸 때만 2·3단계 상세를 읽습니다.

Skill은 어떻게 생겼나

.claude/skills/monthly-report/
  SKILL.md           ← 절차 본문 + 발동 조건
  templates/         ← 참조 파일 (양식, 예시)
  scripts/           ← 실행 스크립트

SKILL.md의 프론트매터가 핵심입니다. description이 1단계에서 늘 로드되는 "책등"이고, Claude는 이것을 보고 발동 여부를 판단합니다.

---
name: monthly-report
description: 월간 매출 데이터를 사내 표준 PDF 리포트로 변환한다.
  "월간 리포트", "매출 정리", "월말 보고서" 요청 시 사용한다.
---

## 절차

1. data/sales/ 에서 해당 월 CSV를 읽는다
2. 지역별·제품별로 집계한다
3. templates/report.html 양식에 채운다
4. scripts/to-pdf.sh 로 변환한다
5. 전월 대비 증감률을 요약해 함께 보고한다

프론트매터 작성 요령과 references/ 폴더 활용법은 SKILL.md 작성법에서 다룹니다.

CLAUDE.md·MCP와 무엇이 다른가

MCP는 외부 데이터베이스나 API와 접속하는 구조로 "무엇을" "어디서" 가져올지를 담당합니다. Skills는 "어떻게" 작업을 진행할지라는 절차적 지식을 담당합니다. MCP로 GitHub 이슈를 가져오고, Skills에 정의된 코딩 규약에 따라 코드를 쓰는 식으로 조합합니다.

참고로 커스텀 슬래시 커맨드는 Skills와 같은 취급으로 통합됐습니다. 사람이 /이름으로 직접 부르는 것과 Claude가 상황을 보고 알아서 쓰는 것의 차이는 슬래시 명령어와 Skills를 참고하세요.

주의점 — Skills는 "Claude가 자동으로 선택하는" 구조이므로 의도한 Skill이 불려오지 않는 경우도 있습니다. Claude가 요청과 description을 바탕으로 자율적으로 판단하기 때문입니다. 특정 지식을 확실히 쓰게 하려면 프롬프트에 Skill 이름을 명시하거나, CLAUDE.md에 직접 쓰는 편이 확실한 경우도 있습니다.

어떤 일이 Skill이 되어야 하나

좋은 후보

• 절차가 정해져 있고 반복되는 일
• 사람마다 다르게 하고 있어 편차가 생기는 일
• 신입에게 매번 설명해야 하는 일

나쁜 후보

• 한 번만 하는 일
• 매번 판단이 크게 달라지는 일
• 모델이 이미 잘하는 일반적인 작업

플러그인으로 Skills 효과 체험하기

직접 만들기 전에 공식 frontend-design 플러그인으로 효과를 체험해 보는 것이 가장 빠릅니다.

플러그인이란

플러그인은 Skills(＋α)를 모아서 배포하는 단위입니다. Anthropic이 공식으로 제공하는 것도 있고 개인 개발자가 만든 것도 있으며, 마켓플레이스(플러그인을 배포하는 점포)에서 설치합니다.

용어를 정리하면 이렇습니다. 플러그인은 Skills를 묶어 배포하는 구조이고, Skills는 플러그인 안에 포함됩니다. 플러그인에는 서브에이전트나 커스텀 커맨드도 함께 담을 수 있습니다. 말하자면 다른 사람이 커스터마이즈한 Claude Code 설정을 통째로 빌려 오는 셈입니다.

설치 절차

1. Claude Code에서 /plugin을 실행합니다. 처음에는 "No plugins available. Add a marketplace first"라고 나오므로 Esc로 돌아갑니다.
2. Anthropic 공식 마켓플레이스를 추가합니다.
3. frontend-design 플러그인을 설치하고 스코프를 고릅니다.
4. /plugin의 Installed 탭에서 설치를 확인합니다.

> /plugin marketplace add anthropics/claude-code
  ⎿  Successfully added marketplace: anthropic-agent-skills

> /plugin install frontend-design@claude-code-plugins

설치 위치는 용도에 맞게 고릅니다. 팀 전원이 같은 Skill을 쓰게 하려면 project scope를 선택합니다.

│   Install for you (user scope)
│ > Install for all collaborators on this repository (project scope)
│   Install for you, in this repo only (local scope)

/plugin을 다시 실행하고 Tab 키로 Installed 탭에 가면 frontend-design Plugin · claude-code-plugins · ✔ enabled 같은 행이 보입니다. 대부분 재시작 없이 바로 쓸 수 있지만, 설치 직후 Run /reload-plugins to activate.가 표시되면 그 명령을 실행해야 유효해집니다.

마켓플레이스를 한번 추가해 두면, 이후에는 /plugin의 Discover 탭에서 방향키로 고르고 Enter로 상세를 본 뒤 설치할 수도 있습니다.

비교 검증 — 플러그인 유무로 어떻게 달라지나

같은 프롬프트로 UI를 만들어 차이를 봅니다.

가상의 AI 개발 기업 LP를 작성해 주세요. HTML + Tailwind CSS로 구현해 주세요.

플러그인 없는 경우 — 기능은 동작하지만 이른바 'AI스러운 디자인'이 되기 쉽습니다. 보라색 계열 그라데이션이 많고, 여백 밸런스가 무너지며, 숫자 표현과 그림자 넣는 방식이 고만고만합니다. 구체적인 지시가 없으면 모델이 '무난한 선택지'를 고르기 때문입니다.

플러그인 있는 경우 — frontend-design을 유효화한 상태에서 같은 프롬프트를 실행하면 Claude가 디자인 전문 지식을 참조하면서 작업합니다. Skill이 제대로 호출되면 CLI에 다음처럼 Skill 이름이 표시됩니다(표시 방식은 버전에 따라 조금 다를 수 있습니다).

> 가상의 AI 개발 기업 LP를 작성해 주세요. HTML + Tailwind CSS로 구현해 주세요.

⏺ /frontend-design

차이가 생기는 이유는 플러그인이 Claude에게 '디자인 서랍'을 주기 때문입니다. 보통 다음 개선이 나타납니다.

• 여백과 스페이싱이 적절해진다
• 색 사용에 일관성이 생긴다
• 컴포넌트의 크기감이 통일된다
• 전체적으로 프로페셔널한 인상이 된다

같은 프롬프트라도 "참조할 수 있는 지식이 있는지"에 따라 출력 품질이 크게 달라집니다. 다만 디자인 취향은 사람마다 다르므로 반드시 플러그인을 써야 하는 것은 아닙니다. 독자적인 브랜드 컬러가 있다면 직접 Skill을 만드는 편이 적절합니다.

/skills 커맨드로 쓸 수 있는 Skills 확인하기

/skills를 실행하면 현재 로드된 Skills 목록이 나옵니다.

> /skills
 Skills
 21 skills · enter/space to cycle, / to search, t to sort, Esc to close
 ❯ 🔒 on         frontend-design:frontend-design · plugin · ~80 tok · locked by plugin
   ✔ on         authoring-goal-prompts · user · ~330 tok
   ✔ on         smart-commit · user · < 20 tok
 Plugin skills are managed via /plugin

사용자·프로젝트 레벨에서 직접 추가한 Skills뿐 아니라 플러그인 경유로 설치한 것도 함께 보입니다. 각 행 끝의 · user, · plugin이 스코프이고, 플러그인 유래 Skills는 /plugin에서 관리합니다. 각 Skill이 로드될 때 소비하는 토큰 수도 표시되므로, 1단계 비용이 얼마나 작은지 여기서 직접 확인할 수 있습니다.

정리

• Skills는 필요할 때만 불러오는 전문 지식 패키지이며, 암묵지를 파일로 만드는 작업입니다. 팀에 한 명만 알던 절차를 문서화하면 사람도 AI도 같이 씁니다.
• 단계적 로딩 덕분에 수백 개를 등록해도 컨텍스트를 압박하지 않습니다.
• CLAUDE.md는 항상 지킬 짧은 규칙, MCP는 외부 접속, Skills는 특정 작업의 절차 — 역할을 나눠 씁니다.
• 공식 플러그인으로 효과를 먼저 체감한 뒤 SKILL.md 작성법으로 직접 만들어 보세요.
• Skills와 혼동하기 쉬운 서브에이전트의 차이는 Skills vs 서브에이전트에서, Skills가 풀어 주는 실제 과제는 Skills가 해결하는 과제에서 이어집니다.