요약: Claude 스킬은 Claude가 스스로 발견하고 작업에 필요할 때만 로드하는 명령어, 스크립트, 리소스 폴더입니다. 각 Claude 스킬은 SKILL.md 파일로 정의되며, 활성화되기 전까지는 컨텍스트 비용이 거의 들지 않고 Claude Code, Claude 앱, Claude Cowork, API 전반에서 실행됩니다. 이 Claude 스킬 가이드는 스킬이 무엇인지, 점진적 공개가 어떻게 작동하는지, 스킬을 설치하는 세 가지 방법, 스킬이 MCP, 명령어, 서브 에이전트와 어떻게 비교되는지, 그리고 실제 예시와 모범 사례를 다룹니다.
Claude 스킬은 사람들이 AI 에이전트를 맞춤 설정하는 방식을 변화시켰습니다. 스킬이 등장하기 전에는 Claude에게 워크플로우를 가르치려면 모든 대화에 동일한 명령어를 붙여넣거나 구성 파일을 컨텍스트 창이 과부하될 때까지 채워 넣어야 했습니다. Claude 스킬은 이 두 가지 문제를 모두 해결합니다. 절차를 한 번만 작성하면 Claude가 작업과 일치할 때 자동으로 가져옵니다.
이러한 하나의 설계 결정 덕분에 이 형식은 빠르게 확산되었습니다. Claude 스킬은 마크다운과 선택적 스크립트로 구성된 일반 폴더이므로 문서를 작성할 수 있는 사람이라면 누구나 스킬을 작성할 수 있습니다. 터미널 에이전트, 채팅 앱, API 통합에서 동일하게 작동합니다. 그리고 필요할 때까지 컨텍스트 외부에 유지되므로 수십 개를 설치해도 속도가 느려지지 않습니다.
이 가이드는 전체 수명 주기를 안내합니다. 형식 이해, 첫 번째 Claude 스킬 설치, 스킬과 다른 확장 메커니즘 간의 선택, 그리고 Claude가 안정적으로 선택하는 스킬 작성 방법을 다룹니다.
Claude 스킬이란 무엇인가요?
Claude 스킬은 Claude가 특정 작업을 더 잘 수행하기 위해 동적으로 로드하는 명령어, 스크립트, 리소스의 체계적인 폴더입니다. 모든 Claude 스킬은 하나의 필수 파일인 SKILL.md를 중심으로 구축됩니다. 이 파일에는 짧은 메타데이터 블록(이름과 설명)과 작업에 대한 전체 명령어가 포함됩니다. 이것이 전체 필수 형식입니다.
이 핵심 파일을 중심으로, Claude 스킬은 작업에 필요한 모든 것을 묶을 수 있습니다. 실행 가능한 스크립트, 템플릿, 참조 문서, 체크리스트 또는 예시 출력 등이 있습니다. 브랜드 가이드라인 스킬은 로고 파일과 어조 규칙을 포함할 수 있습니다. 보고 스킬은 매번 동일한 방식으로 차트를 생성하는 Python 스크립트를 포함할 수 있습니다.
구체적인 예시를 통해 구조를 명확히 알 수 있습니다. 분기별 보고서 스킬에는 설명에 "사용자가 분기별 비즈니스 보고서를 요청할 때 사용"이라고 적힌 SKILL.md 파일, 섹션 순서와 어조를 지정하는 명령어, 지난 분기 보고서를 표준으로 삼는 참조 파일, 그리고 숫자를 형식화된 표로 가져오는 스크립트가 포함될 수 있습니다. 이 모든 것은 Claude가 추측할 필요가 없는 코드입니다. 한 번 작성되면 매번 따르는 절차입니다.
영리한 부분은 점진적 공개입니다. 이는 Claude 스킬을 저렴하게 유지하는 로딩 모델입니다. 세 단계로 작동합니다.
- 발견 — 시작 시 Claude는 각 스킬의 이름과 설명만 봅니다. 이는 스킬당 수십 개의 토큰만 소비하므로 대규모 라이브러리도 저렴하게 유지됩니다.
- 활성화 — 요청이 스킬의 설명과 일치하면 Claude는 전체 SKILL.md 명령어를 컨텍스트로 읽어들입니다.
- 실행 — Claude는 명령어를 따르며, 작업에 실제로 필요한 경우에만 번들된 참조 파일을 열거나 번들된 스크립트를 실행합니다.
Claude 스킬은 Claude 생태계 전반에서 이식 가능합니다. 동일한 폴더 형식은 Claude Code (파일 시스템 기반, 업로드 불필요), 웹 및 데스크톱의 Claude 앱 (미리 빌드된 스킬이 문서 생성을 지원하며, 설정에서 사용자 지정 스킬을 추가할 수 있음), Claude Cowork (Anthropic의 비개발자용 에이전트 작업 공간), 그리고 개발자에게 프로그래밍 방식 제어 및 버전 관리를 제공하는 전용 스킬 엔드포인트가 있는 Claude API 및 Agent SDK에서 실행됩니다. 스킬을 한 번 구축하면 어디든 함께 이동합니다.
Claude 스킬은 어떻게 작동하나요?
Claude 스킬은 설명 일치를 통해 작동합니다. 모델 자체가 스킬이 언제 관련성이 있는지 결정하고, 로드하고, 적용합니다. 수동 트리거링은 필요하지 않습니다. Claude에게 "이 20개의 리드에 대한 아웃리치를 작성해줘"라고 요청하고, 아웃리치 스킬의 설명에 콜드 이메일이 언급되어 있으면 Claude는 스스로 활성화합니다.
이것이 기본 모델 호출 경로이며, 스킬을 이전의 맞춤 설정 방식과 구분하는 요소입니다. 하지만 Claude 스킬은 사용자 호출도 가능합니다. Claude Code에서 모든 스킬은 슬래시 명령어로도 등록되므로, /skill-name을 입력하면 강제로 실행됩니다. 프런트매터 스위치를 통해 작성자는 이 동작을 조정할 수 있습니다. 예를 들어, 파괴적인 워크플로우에 대한 자동 호출을 비활성화하여 사람이 명시적으로 호출할 때만 실행되도록 할 수 있습니다.
실제 요청에 대한 전체 흐름은 다음과 같습니다. "시리즈 B 핀테크의 RevOps 책임자 잠재 고객 목록을 만들어줘"라고 입력합니다. Claude는 스킬 메타데이터를 스캔하고, ICP 및 리드 목록이 설명에 언급된 잠재 고객 발굴 스킬을 찾아 전체 명령어를 읽습니다. 이 명령어는 적용할 검색 필터, 연락처 데이터 확인 방법, 출력 형식을 알려줍니다. 이 순간까지의 총 오버헤드는 컨텍스트에 조용히 있는 한 줄의 메타데이터입니다.
일상적으로 Claude 스킬을 사용하는 방법을 아는 것은 놀랍도록 지루합니다. 대부분은 결과물을 요청하기만 하면 됩니다. 세 가지 속성이 프롬프트 라이브러리가 결코 할 수 없었던 시스템 확장을 가능하게 합니다.
- 구성 가능성 — 스킬은 쌓입니다. 하나의 요청으로 데이터 분석 스킬, 브랜드 보이스 스킬, 스프레드시트 스킬을 함께 활성화할 수 있으며, 각 스킬은 워크플로우의 일부를 기여합니다.
- 토큰 효율성 — 활성화되기 전까지 스킬은 한 줄의 메타데이터만 소비합니다. 이는 관련성이 있든 없든 모든 세션에서 컨텍스트를 소모하는 단일 명령어 파일과 비교됩니다.
- 결정론적 정확성 — 번들된 스크립트를 통해 스킬은 모델이 매번 즉흥적으로 처리하도록 요청하는 대신 실제 코드에서 섬세한 단계(날짜 계산, 파일 변환, API 형식 출력)를 수행할 수 있습니다.
Claude 스킬 설치 방법
Claude 스킬을 설치하는 세 가지 검증된 방법이 있습니다. 플러그인 마켓플레이스를 통하거나, 오픈 소스 스킬 CLI를 사용하거나, 폴더를 스킬 디렉토리에 넣는 것입니다. Claude Code에 스킬을 추가하는 방법을 찾고 있다면, 세 가지 방법 모두 작동합니다. 편리성과 소스에 대한 신뢰도에서 차이가 있습니다.
- 1플러그인 마켓플레이스에서 설치
Claude Code에서
/plugin을 실행하여 플러그인 브라우저를 엽니다. '발견' 탭에는 공식 Anthropic 마켓플레이스의 플러그인(많은 플러그인이 Claude 스킬을 번들로 제공)이 나열됩니다. 커뮤니티 마켓플레이스를 추가하려면 GitHub 저장소와 함께/plugin marketplace add owner/repo를 실행한 다음 해당 목록에서 설치합니다. 설치된 스킬은 재시작 없이 세션에서 사용할 수 있습니다. - 2오픈 소스 스킬 CLI 사용
npx skills설치 관리자(skills.sh)는 GitHub를 스킬 패키지 레지스트리로 취급합니다. 별도의 계정이 필요 없습니다. 하나의 명령어로 에이전트에 스킬을 설치하고 구성합니다. 실제 작동 예시:npx skills add LessieAI/lessie-skill -y -g는 Lessie 구매자 검색 스킬을 전역적으로 비대화식으로 설치합니다. 더 많은 스킬을 찾으려면npx skills find를 실행하거나 스킬 CLI 통합 페이지에서 에이전트별 설정을 확인하세요. - 3스킬 폴더 수동 추가
모든 프로젝트에서 사용할 수 있는 개인 스킬의 경우
~/.claude/skills/에 SKILL.md 파일이 포함된 폴더를 만들거나, 팀 전체가 git을 통해 사용하는 프로젝트 스킬의 경우 저장소 내.claude/skills/에 만듭니다. 이는 GitHub에서 다운로드한 스킬을 설치하는 방법이기도 합니다. 압축을 풀고 폴더를 넣은 다음 Claude에게 스킬을 인식하는지 확인하도록 요청합니다.
어떤 경로를 선택하든 설치 확인은 동일합니다. 새 세션을 시작하고 Claude에게 어떤 스킬을 볼 수 있는지 묻거나 /를 입력하고 목록에서 스킬의 슬래시 명령어를 찾습니다. 스킬이 스스로 활성화되지 않는다면, 보통 설명이 원인입니다. Claude가 관련성을 결정할 때 읽는 유일한 텍스트이므로, 요청할 때 실제로 사용하는 단어를 언급해야 합니다.
Claude Code 외부에서는 설치가 훨씬 간단합니다. Claude 앱에서는 설정에서 스킬을 활성화하고 사용자 지정 스킬을 추가할 수 있으며, API 사용자는 스킬을 한 번 업로드하고 요청에서 ID로 참조합니다. 폴더 형식은 모든 곳에서 동일하므로 로컬에서 테스트한 스킬은 수정 없이 프로덕션으로 이식됩니다.
Claude 스킬 vs MCP, 명령어, 서브 에이전트
간단히 말해, Claude 스킬은 지식과 절차를 패키징하고, MCP는 외부 시스템에 대한 실시간 연결을 제공하며, 슬래시 명령어는 사용자 호출 단축키이고, 서브 에이전트는 자체 컨텍스트를 가진 병렬 작업자입니다. 이들은 경쟁자가 아니라 보완 관계입니다. 성숙한 설정에서는 이 네 가지를 모두 사용합니다.
| 메커니즘 | 무엇인가요 | 누가 트리거하나요 | 가장 적합한 용도 | 컨텍스트 비용 |
|---|---|---|---|---|
| 스킬 | 명령어, 스크립트, 리소스 폴더 (SKILL.md) | 작업이 일치할 때 Claude; 또는 슬래시 명령어를 통해 사용자 | 절차, 전문 지식, 반복 가능한 워크플로우 | 활성화되기 전까지 거의 없음 |
| MCP | Claude를 외부 도구 및 데이터에 연결하는 개방형 프로토콜 | 연결된 시스템이 필요할 때 Claude | 실시간 데이터, API, 데이터베이스, 타사 서비스 | 서버가 연결되어 있는 동안 도구 정의 로드 |
| 슬래시 명령어 | 이름으로 호출되는 프롬프트 단축키 (이제 스킬에 병합됨) | 사용자가 명시적으로 | 요청 시 원하는 빈번한 수동 작업 | 호출될 때만 로드됨 |
| 서브 에이전트 | 자체 컨텍스트와 도구를 가진 별도의 에이전트 인스턴스 | Claude가 위임하거나 사용자가 요청 | 메인 스레드를 오염시킬 수 있는 병렬 또는 격리된 작업 | 자체 컨텍스트 창; 요약만 반환 |
Claude 스킬 vs MCP. Claude 스킬은 Claude에게 자격 기준을 가르칠 수 있지만, 런타임에 라이브 데이터베이스에 접근할 수는 없습니다. 이것은 MCP의 역할입니다. 2024년 말 Anthropic이 도입한 MCP는 USB-C가 포트를 표준화한 것처럼 외부 시스템에 대한 연결을 표준화합니다. 스킬은 이를 사용하는 노하우를 표준화합니다. 이 둘은 자연스럽게 결합됩니다. MCP는 데이터를 가져오고, 스킬은 그 데이터를 어떻게 처리할지 지시합니다. 예를 들어, 실시간 LinkedIn 인물 데이터가 필요하다면 LinkedIn MCP 가이드를 참조하세요.
Claude 스킬 vs 명령어. Claude Code는 원래 명령어와 스킬을 별도의 시스템으로 유지했습니다. 이후 병합되었으며, 두 위치의 마크다운 파일은 동일한 슬래시 명령어 인터페이스를 생성합니다. 스킬은 번들 파일, 프런트매터 제어, 그리고 결정적으로 모델 호출을 지원하므로 앞으로 권장되는 형식입니다. 명령어는 사용자가 기억하기를 기다리지만, 스킬은 자발적으로 작동합니다.
Claude 스킬 vs 에이전트. 서브 에이전트는 작업자이고, 스킬은 매뉴얼입니다. 서브 에이전트는 작업이 병렬로 실행되거나 주 컨텍스트에서 벗어나야 할 때 빛을 발합니다. 예를 들어, 연구 조사나 코드 검토와 같은 경우입니다. 스킬은 주 에이전트가 방법을 알아야 할 때 빛을 발합니다. 패턴은 중첩됩니다. 서브 에이전트는 스킬을 로드할 수 있고, 스킬은 Claude에게 서브 에이전트에 위임하도록 지시할 수 있습니다.
선택을 위한 실용적인 규칙은 다음과 같습니다. 문제가 "Claude가 우리가 이것을 어떻게 하는지 모른다"면 Claude 스킬을 작성하십시오. "Claude가 데이터를 볼 수 없다"면 MCP 서버를 추가하십시오. 동일한 요청을 계속 입력한다면 슬래시 명령어로 스킬을 직접 호출하십시오. 그리고 작업이 하나의 컨텍스트 창에 너무 크다면 서브 에이전트에게 맡기십시오. 2026년 대부분의 프로덕션 설정은 이 네 가지를 함께 조용히 실행합니다.
Claude 스킬 예시 및 사용 사례
최고의 Claude 스킬 예시는 한 가지 특징을 공유합니다. 바로 사람이 수동으로 반복했던 절차를 인코딩한다는 것입니다. 다음은 영업, 문서, 엔지니어링, 마케팅 전반에서 이미 프로덕션 환경에서 작동하는 다섯 가지 패턴입니다. 전체 순위 목록은 최고의 Claude 스킬 요약을 참조하세요.
- 영업 및 GTM 잠재 고객 발굴 — Lessie 스킬은 터미널에서 완전한 아웃바운드 워크플로우를 실행합니다. ICP와 일치하는 검증된 구매자를 100개 이상의 라이브 소스에서 찾아내고, 역할 및 회사 컨텍스트로 풍부하게 만들고, 개인화된 아웃리치를 작성합니다. 이메일 정확도는 95%에 달합니다. 이러한 신호 기반의 개인화된 접근 방식을 사용하는 팀은 응답률을 약 1%에서 12%로 높였습니다.
- 문서 생산 — Anthropic의 자체 문서 스킬(docx, pptx, xlsx, pdf)은 Claude가 적절하게 형식화된 Word 파일, 슬라이드 데크, 스프레드시트를 생성할 수 있도록 합니다. 이들은 오픈 소스이며 결정론적 출력을 위한 스크립트 번들링의 걸작입니다.
- 프론트엔드 디자인 — Anthropic의 프론트엔드 디자인 스킬은 Claude를 일반적인 AI 스타일링을 넘어 독특하고 프로덕션 수준의 인터페이스로 발전시킵니다. 팀은 이를 포크하여 자체 디자인 토큰을 접목합니다.
- 마케팅 콘텐츠 운영 — 브랜드 보이스 스킬은 톤 규칙, 금지 문구, 서식 지정을 인코딩하여 모든 초안이 브랜드에 맞게 작성되도록 합니다. 당사의 마케팅을 위한 Claude 스킬 가이드 는 SEO 브리핑부터 캠페인 보고에 이르는 전체 스택을 다룹니다.
- 내부 SOP 및 검토 — 팀은
.claude/skills/에 릴리스 체크리스트, 보안 검토 단계, 데이터 처리 규칙을 프로젝트 스킬로 패키징하여 절차가 저장소와 함께 제공되고 모든 팀원(사람 또는 에이전트)이 동일한 절차를 따르도록 합니다. - 채용 및 인재 검색 — 동일한 구매자 검색 메커니즘이 후보자에게도 적용됩니다. 소싱 스킬은 자격 기준과 검색 전략을 인코딩하여 채용 관리자가 "계약직에 관심 있는 시니어 백엔드 엔지니어"를 요청하면 원시 키워드 일치가 아닌 검증된 후보자 목록을 얻을 수 있습니다.
분할에 주목하세요. 일부 Claude 스킬은 기능을 추가하고(문서, 구매자 검색), 다른 스킬은 판단을 추가합니다(브랜드 보이스, 검토 체크리스트). 대부분의 팀은 둘 다를 원하며, 이것이 바로 구성 가능성의 목적입니다. 한 번의 오후 워크플로우로 위의 세 가지 예시를 연결할 수 있습니다. Lessie 스킬은 목록을 만들고, 브랜드 보이스 스킬은 아웃리치를 작성하며, 문서 스킬은 결과를 월요일 파이프라인 검토를 위한 데크로 패키징합니다.
Claude 스킬 모범 사례
Claude 스킬 모범 사례는 세 가지 원칙으로 요약됩니다. 안정적으로 트리거되는 스킬을 작성하고, 비용을 절감할 수 있을 만큼 간결하게 유지하며, 타사 스킬을 실행하는 모든 코드와 동일한 주의를 기울여 다루는 것입니다. 자세한 내용은 다음과 같습니다.
- 설명이 작동하도록 만드세요. 설명은 Claude가 스킬 활성화를 결정하기 전에 보는 유일한 것입니다. 작업, 트리거, 사용자가 실제로 말할 키워드를 명확히 언급하세요. 모호한 설명은 절대 실행되지 않는 스킬이 됩니다.
- SKILL.md는 하나의 작업에 집중하세요. 하나의 스킬, 하나의 워크플로우. 파일이 너무 커지면 세부 사항을 참조 파일로 분할하고, 필요할 때만 로드되도록 점진적 공개를 신뢰하세요.
- 설치하기 전에 타사 Claude 스킬을 검토하세요. 스킬에는 실행 가능한 스크립트가 포함될 수 있으며, 명령어 자체는 에이전트를 의도하지 않은 방식으로 조종할 수 있습니다. SKILL.md와 모든 번들 스크립트를 읽거나 Claude에게 요약하도록 요청한 다음 워크플로우에 추가하세요.
- 소스를 고정하세요. 신뢰할 수 있는 저장소에서 설치하고, 일회성 포크보다 유지 관리되는 게시자를 선호하며, 업데이트 후 다시 검토하세요. 스킬 마켓플레이스를 패키지 레지스트리처럼 다루세요. 실제로 그렇기 때문입니다.
- 프로젝트 스킬을 버전 관리하세요.
.claude/skills/의 스킬은 저장소와 함께 이동합니다. 변경 사항은 다른 파일과 마찬가지로 코드 검토, 기록, 롤백을 거칩니다. 이 감사 추적은 워크플로우가 오작동할 때 안전망이 됩니다. - 실제 기록을 기반으로 반복하세요. Claude가 스킬을 잘못 적용할 때, 해결책은 보통 명령어에 한 줄의 설명을 추가하는 것입니다. 스킬은 프롬프트와 동일한 긴밀한 피드백 루프를 보상합니다. 단, 문제를 한 번에 영구적으로 해결합니다.