본문으로 건너뛰기

스킬(Skills): 온디맨드 전문성

고급
What you'll learn
  • 스킬이 무엇인지, 그리고 모든 것을 CLAUDE.md에 쑤셔넣는 것과 어떻게 다른지 정의한다
  • SKILL.md — 프론트매터 + 지시 — 를 읽고 쓰며, 왜 description이 트리거인지 이해한다
  • 점진적 공개를 설명하고 왜 그것이 컨텍스트를 부풀리지 않고 많은 스킬을 확장하게 하는지 안다
  • 스킬이 사는 세 곳을 안다: 개인, 프로젝트, 플러그인 번들
  • Skill, 슬래시 명령, 서브에이전트, MCP 사이에서 올바르게 선택한다
  • 스킬이 트리거되지 않게 하는 네 가지 흔한 실수를 피한다

**스킬(Skill)**은 전문성 — 지시와 선택적 스크립트 및 리소스 — 을 패키징하며, Claude가 관련 있을 때만 로드합니다. 모든 것을 CLAUDE.md에 쑤셔넣는 대신, Claude에 온디맨드로 끌어오는 기능 라이브러리를 줍니다.

구조​

스킬은 SKILL.md가 있는 폴더입니다: YAML 프론트매터 + 지시.

---
name: pdf-forms
description: Use when the user needs to fill, read, or generate PDF forms.
---

# PDF Forms
Steps and rules for working with PDF forms…
(optionally reference scripts/ or resources/ in this folder)
Pro tip
  • description이 트리거입니다 — Claude가 언제 스킬을 활성화할지 결정하려고 이를 읽습니다. "Use when…"으로, 올바른 때에 로드되고 그 외에는 안 되도록 충분히 구체적으로 쓰세요.

점진적 공개 (스킬이 확장되는 이유)​

Claude는 모든 스킬의 전체 본문을 미리 로드하지 않습니다 — 가벼운 name + description만 보고, 요청이 매칭될 때만 전체 지시를 끌어오고(스크립트를 실행합니다). 그래서 많은 스킬이 설치돼 있어도 컨텍스트가 가볍게 유지됩니다.

스킬이 사는 곳​

Guided walkthrough1 of 3
  1. ~/.claude/skills/<name>/SKILL.md — 당신 것으로 남으며, 모든 프로젝트에서 사용 가능.

AILmanac은 바로 쓸 수 있는 스킬 팩 7개를 제공합니다 — 하나를 복사해 시험해 보세요.

실습 예제: 스스로 트리거되는 스킬​

~/.claude/skills/release-notes/SKILL.md를 만드세요:

---
name: release-notes
description: Use when the user asks to write release notes or a changelog from git history.
---

# Release Notes
1. Run `git log <last-tag>..HEAD --oneline` to get the commits.
2. Group them into Features / Fixes / Breaking changes.
3. Write user-facing notes — what changed for *users*, not commit messages.
4. Output Markdown ready to paste into a GitHub release.

나중에 아래 프롬프트를 입력합니다. Claude는 이 단계들을 컨텍스트에 가진 적이 없지만 — 요청이 description과 매칭되므로 전체 SKILL.md를 끌어와 git log를 실행하고 그룹화된 노트를 만듭니다. 이름으로 아무것도 호출하지 않았습니다; description이 라우팅을 했습니다. 같은 폴더에 scripts/ 파일을 추가하면 스킬이 1단계의 일부로 그것을 실행할 수 있습니다.

의도로 스킬 트리거 — 이름 불필요

Draft release notes since v1.4.

Skill vs 명령 vs 서브에이전트 vs MCP​

도구무엇인가당신 vs Claude가 트리거
슬래시 명령저장된 프롬프트당신이 호출
스킬온디맨드 전문성 + 스크립트Claude가 관련 있을 때 로드
서브에이전트자체 컨텍스트를 가진 위임된 에이전트Claude가 위임
MCP외부 도구/데이터로의 연결호출할 도구를 제공
Key takeaways
  • 온디맨드로 발동하고 싶다 → 슬래시 명령.
  • Claude가 절차를 알고 관련 있을 때 적용하길 원한다 → 스킬.
  • 작업이 별도 컨텍스트에서 일어나야 한다 → 서브에이전트.
  • 외부 시스템에 도달해야 한다 → MCP.

흔한 실수​

Watch out
  • 트리거되지 않는 description. "PDF를 돕는다"는 너무 모호합니다; "Use when the user needs to fill, read, or generate PDF forms"는 Claude에게 언제 로드할지 정확히 알려줍니다. description은 활성화 메커니즘 전부입니다 — 사람이 아니라 매칭을 위해 쓰세요.
  • 대신 모든 것을 CLAUDE.md에 넣기. CLAUDE.md는 매 세션 로드되어 항상 컨텍스트를 소모하지만; 스킬은 관련 있을 때만 로드됩니다. 상황적 절차는 스킬로 옮기고 CLAUDE.md는 항상 참인 프로젝트 규칙을 위해 두세요.
  • 하나의 거대한 스킬. 날카롭게 서술된 작은 스킬 여럿이 하나의 만능 스킬보다 라우팅이 낫습니다 — 점진적 공개는 각 description이 구체적일 때만 도움이 됩니다.
  • 공유 가능하다는 걸 잊기. git에 커밋된 .claude/skills/의 프로젝트 스킬은 팀 전체에 기능을 주고; ~/.claude/skills/의 개인 스킬은 당신 것으로 남습니다.

용어 되짚기​

Enter 또는 스페이스 키를 눌러 카드를 뒤집습니다. 좌우 화살표 키로 카드를 이동할 수 있습니다.용어가 표시되었습니다.
1 / 6

스스로 점검하기​

스스로 점검하기

0/5
  1. SKILL.md에서 Claude가 스킬을 언제 활성화할지 실제로 결정하는 것은?
  2. 점진적 공개란 무엇인가요?
  3. git으로 팀 전체가 기능을 얻게 하고 싶습니다. 스킬을 어디에 두나요?
  4. 이름으로, 온디맨드로, 스스로 무언가를 발동하고 싶습니다. 어떤 도구가 맞나요?
  5. 상황적 절차를 CLAUDE.md에 넣는 것보다 스킬을 선호하는 이유는?

다음​