Claude Skills: 정의와 설치 방법
Skill은 Claude가 필요할 때만 로드하는 지침 폴더입니다. 이 폴더가 어디에 위치하는지, 어떻게 설치하는지, MCP와 어떻게 다른지 알아보겠습니다.
Claude Skill은 Claude가 필요할 때만 로드하는 지침이 담긴 폴더입니다. SKILL.md 지침이 담긴 파일이며, 선택적으로 스크립트와 참고 파일이 포함됩니다. Claude는 설명을 읽고 해당 Skill이 관련 있는지 판단한 다음, 그때 나머지를 로드합니다. Claude Code Skills도 같은 방식으로 작동하며 다음 명령으로 호출합니다 /skill-name. Skills는 Agent Skills 공개 표준을 따르므로 동일한 파일을 다른 AI 도구에서도 사용할 수 있습니다.
Claude Skills와 MCP, 플러그인 및 프로젝트
이 네 가지는 끊임없이 혼동되며, 잘못된 것을 선택하면 결국 전혀 실행되지 않는 무언가를 설치하게 됩니다. 차이는 무엇을 포함하는지가 아닙니다. Claude가 언제 로드하는지, 그리고 어떤 일을 수행하는지에 있습니다.
| Claude에 제공하는 것 | 로드되는 시점 | 사용 용도 | |
|---|---|---|---|
| Skill | 절차 - 작업을 수행하는 방법 | 필요할 때, 관련성이 있을 때 | 반복 가능한 작업: 보고서 형식, 검토 체크리스트, 조직의 스타일 |
| MCP | 외부 도구 또는 데이터 소스에 대한 액세스 | 도구가 호출될 때 | Jira, Slack, 데이터베이스, 파일 저장소에 연결 |
| 플러그인 | 번들: Skills, Agents, hooks, MCP 서버 | 플러그인이 활성화될 때 | 전체 워크플로를 하나의 설치 가능한 단위로 제공 |
| 프로젝트 | 정적인 배경 지식 | 항상, 해당 프로젝트의 모든 채팅에서 | 빠지면 안 되는 컨텍스트 |
- MCP는 Claude에게 도구를 제공합니다. Skills는 도구 사용법을 가르칩니다. 서로 함께 작동합니다.
- 프로젝트는 항상 로드됩니다. Skills는 작업과 일치할 때만 로드됩니다.
- 사용자 지정 지침은 모든 대화에 적용됩니다. Skills는 특정 종류의 작업에 적용됩니다.
Claude Code Skills의 위치
Claude Code에서 Skills는 디스크에 있는 디렉터리입니다. 해당 디렉터리를 어디에 두느냐에 따라 사용할 수 있는 사람이 결정됩니다. 위치는 네 곳이며, 이름이 같은 Skills가 둘 이상일 경우 고정된 우선순위에 따라 적용됩니다.
| 위치 | 경로 | 적용 대상 |
|---|---|---|
| Enterprise | 관리형 설정에서 지정 | 조직의 모든 사용자 |
| 개인용 | ~/.claude/skills/<skill-name>/SKILL.md |
모든 프로젝트 |
| 프로젝트 | .claude/skills/<skill-name>/SKILL.md |
해당 프로젝트에만 |
| 플러그인 | <plugin>/skills/<skill-name>/SKILL.md |
플러그인이 활성화된 위치 |
두 Skills의 이름이 같으면 Enterprise가 개인용보다 우선하고, 개인용이 프로젝트보다 우선합니다. 플러그인 Skills에는 다음과 같이 네임스페이스가 지정됩니다 /plugin-name:skill-name이므로 서로 충돌하지 않습니다. Claude Code는 해당 폴더를 감시하며 세션 중 편집된 내용을 즉시 반영합니다 - 다시 시작할 필요가 없습니다.
거의 모든 사람이 저지르는 실수
Cowork와 클라우드 세션은 읽지 않습니다 ~/.claude/skills/ 컴퓨터에서.
claude.ai 계정에서 활성화된 Skills가 세션 시작 시 동기화되어 로드됩니다. 로컬 폴더에만 있는 Skills는 여기에서 “skill not found”로 표시됩니다. Cowork에서 사용하려면 대신 계정에서 활성화하세요.
Claude Skills 설치 방법
세 가지 환경에는 서로 다른 경로가 있습니다. 실제로 사용하는 환경을 선택하세요. 각각 2분도 걸리지 않으며 코드를 작성할 필요도 없습니다.
Claude(claude.ai 및 데스크톱)
- 계정에서 Customize를 연 다음 Skills를 선택하세요.
- +를 클릭한 다음 직접 만든
SKILL.md폴더를 업로드하거나 Skills 찾아보기를 클릭해 디렉터리를 여세요. - Skills를 켜세요.
- 채팅을 시작하고 작업을 설명하세요. Claude가 작업에 맞는 Skills를 불러옵니다.
계정에서 코드 실행을 활성화해야 합니다. Free, Pro, Max, Team, Enterprise에서 사용할 수 있습니다.
Claude Code
- 폴더를 생성하세요:
~/.claude/skills/my-skill/모든 프로젝트에 적용하거나.claude/skills/my-skill/리포지토리 하나에만 적용됩니다. - 넣기
SKILL.md그 안에. - 입력
/my-skill세션에서 바로 사용하거나 작업을 설명하기만 하면 Claude가 이를 처리하도록 하세요.
다시 시작할 필요가 없습니다. Claude Code가 해당 폴더를 감시하며 변경 사항을 실시간으로 반영합니다.
Cowork
- claude.ai 계정에서 Skills를 활성화하세요 - 데스크톱 사이드바에서 Customize를 선택하거나 claude.ai의 Skills 설정으로 이동하세요.
- Cowork 세션을 시작하세요. 계정의 Skills가 세션 시작 시 동기화됩니다.
- 이름으로 호출하거나 Claude가 선택하도록 할 수 있습니다.
클라우드 세션은 저장소의 에 커밋된 프로젝트 Skills도 추가로 불러옵니다. .claude/skills/ 폴더입니다.
SKILL.md 파일에는 실제로 무엇이 들어 있나요?
Skill은 작은 YAML 헤더가 포함된 Markdown입니다. 형식은 이것이 전부입니다. 텍스트 편집기에서 체크리스트를 작성할 수 있다면 Skill도 작성할 수 있습니다.
--- name: quarterly-report description: 원시 CSV 내보내기 파일에서 분기별 매출 보고서를 작성합니다 when_to_use: 누군가 분기별 보고서를 요청하거나 매출 내보내기 파일을 전달할 때 allowed-tools: Read Grep --- ## 단계 1. CSV를 읽고 열 머리글이 예상 스키마와 일치하는지 확인합니다. 2. 제품군별로 묶은 다음 월별로 매출을 집계합니다. 3. 이전 달 대비 15% 넘게 변동한 달을 표시합니다. 4. 아래 형식으로 요약을 작성합니다.
when_to_use.헤더 아래의 내용은 모두 자신의 말로 작성한 지침일 뿐입니다. SDK도, 빌드 단계도, 배포도 필요하지 않습니다.
Claude Cowork Skills 사용하기
Cowork는 채팅 창 안이 아니라 사용자의 파일과 작업을 대상으로 Claude를 실행하며, Skills는 팀에서 말하는 “제대로 완료됨”의 의미를 Claude에 알려 주는 방법입니다. 사람들이 자주 헷갈리는 규칙은 다음과 같습니다. Cowork는 컴퓨터의 skills 폴더를 읽지 않습니다. 대화형 Cowork 세션과 예약된 Cowork 세션 모두 claude.ai 계정에서 활성화한 Skills를 세션 시작 시 동기화하여 불러옵니다.
따라서 워크플로는 다음과 같습니다. Skill을 한 번 작성하고 계정에서 활성화하면 모든 Cowork 세션과 예약 실행에 적용됩니다.
Anthropic Agent Skills: 종속이 아닌 오픈 표준
Agent Skills 사양은 다음에서 오픈 표준으로 공개되어 있습니다 agentskills.io또한 자체 플랫폼에서 Skills 지원을 구현하려는 사람을 위해 참조용 Python SDK도 제공됩니다. Claude Code는 표준을 따르면서 그 위에 자체 확장 기능인 호출 제어, 서브에이전트 실행, 동적 컨텍스트 주입을 추가합니다.
두 번 읽어 볼 만한 부분은 실질적인 결과입니다. 오늘 작성한 Skill은 공개 사양이 적용되는 Markdown 파일입니다. 이 표준을 채택한 다른 AI 도구로 옮기더라도 파일은 그대로 함께 이동합니다.
Skill이 실행되지 않을 때
Skill이 전혀 실행되지 않음
열 번 중 아홉 번은 지침이 아니라 설명이 문제입니다. Claude는 결정을 내릴 때 설명만 읽습니다. 구체적인 사용 사례를 앞에 두도록 다시 작성하고 다음을 추가하세요. when_to_use 사람들이 실제로 입력하는 문구를 사용하세요.
스킬이 너무 자주 트리거됩니다
설명이 너무 광범위합니다. 구체적인 상황으로 범위를 좁히거나 다음을 설정하세요. disable-model-invocation: true 입력했을 때만 실행되도록 /skill-name 직접 하세요.
Cowork 또는 예약 실행에서는 작동하지 않지만 로컬에서는 작동합니다
다음 위치에 있습니다 ~/.claude/skills/ 그 외에는 없습니다. 이러한 세션은 새로 시작하며 claude.ai 계정의 스킬을 불러옵니다. 계정에 활성화하거나 리포지토리의 .claude/skills/ 클라우드 세션용.
Claude 스킬: 자주 묻는 질문
Claude 스킬이란 무엇인가요?
SKILL.md 파일과 지침이 들어 있고, 선택적으로 스크립트와 참조 파일이 포함된 폴더입니다. Claude는 스킬의 설명을 읽고 요청과 관련이 있다고 판단할 때만 전체 지침을 불러옵니다. 이를 점진적 공개라고 하며, 많은 스킬을 설치해도 컨텍스트 창이 가득 차지 않는 이유입니다.
Claude Code 스킬은 어디에 있나요?
개인 스킬은 ~/.claude/skills/<skill-name>/SKILL.md에 저장하며 모든 프로젝트에 적용됩니다. 프로젝트 스킬은 리포지토리 내부의 .claude/skills/<skill-name>/SKILL.md에 저장하며 해당 프로젝트에만 적용됩니다. 플러그인에는 <plugin>/skills/<skill-name>/SKILL.md 경로로 스킬이 포함되고, 엔터프라이즈 스킬은 관리형 설정을 통해 지정됩니다.
Claude 스킬과 MCP의 차이점은 무엇인가요?
MCP는 Claude를 외부 서비스와 데이터 소스에 연결하며 도구를 제공합니다. 스킬은 절차적 지식, 즉 작업을 올바르게 수행하는 방법에 대한 지침을 제공합니다. 둘은 상호 보완적이며 대안 관계가 아닙니다. MCP 커넥터는 Claude가 Jira에 액세스할 수 있게 하고, 스킬은 팀에서 티켓을 작성하는 방법을 알려줍니다.
Claude 스킬은 어떻게 설치하나요?
claude.ai에서 Customize를 열고 Skills를 선택한 다음 +를 클릭해 스킬을 업로드하거나 디렉터리를 찾아보세요. Claude Code에서는 스킬 폴더를 ~/.claude/skills/ 또는 프로젝트의 .claude/skills/에 넣고 /skill-name으로 호출하세요. Cowork에서는 claude.ai 계정에 스킬을 활성화하면 세션 시작 시 동기화됩니다.
Claude 스킬은 Cowork에서 작동하나요?
네, 하지만 로컬 폴더의 스킬은 사용할 수 없습니다. 대화형 세션과 예약된 세션을 포함한 Cowork 세션은 컴퓨터의 ~/.claude/skills/가 아니라 claude.ai 계정에 활성화된 스킬을 불러옵니다. Desktop 사이드바의 Customize 또는 claude.ai의 스킬 설정에서 계정에 스킬을 활성화하세요.
스킬을 작성하려면 코딩 방법을 알아야 하나요?
아니요. skill은 짧은 YAML 헤더(이름, 설명 및 일반 언어로 작성한 지침)가 포함된 Markdown 파일입니다. 스크립트는 선택 사항이며 고급 동작에만 필요합니다. 체크리스트를 작성할 수 있다면 skill도 작성할 수 있습니다.
Claude Skills는 무료인가요?
Free, Pro, Max, Team 및 Enterprise 요금제에서 이 기능을 사용할 수 있으며, 코드 실행을 활성화해야 합니다. Word, Excel 및 PowerPoint 문서 생성과 같은 Anthropic 자체 Skills는 모든 사용자가 이용할 수 있습니다. 구매하거나 다운로드하는 Skills의 가격은 제작자가 정합니다.
다른 사람이 작성한 skill을 설치해도 안전한가요?
skill은 Claude가 따를 지침이므로, 실행하기 전에 스크립트를 읽듯이 읽어 보세요. Enterprise 요금제에서는 조직이 skill 및 플러그인 검사를 활성화하여 업로드된 파일에 악성 콘텐츠가 있는지 확인할 수 있습니다. 그 외에는 일반적인 원칙을 따르세요. 출처를 확인할 수 있는 곳에서 설치하세요.
Anthropic Agent Skills란 무엇인가요?
Agent Skills는 이 형식의 기반이 되는 오픈 사양으로, agentskills.io에서 레퍼런스 Python SDK와 함께 공개되어 있습니다. 즉, 이 표준을 채택하는 모든 플랫폼이 동일한 SKILL.md 파일을 읽을 수 있으므로 skill이 Claude에 종속되지 않습니다. Anthropic은 자체적으로 유지 관리하는 Skills도 제공하며, Claude는 관련성이 있을 때 이를 자동으로 호출합니다.
skill과 Claude 프로젝트의 차이점은 무엇인가요?
프로젝트는 그 안의 모든 채팅에 로드되는 고정 배경 지식을 제공합니다. skill은 작업이 일치할 때만 활성화되는 절차를 제공하며, 하나의 프로젝트 안이 아니라 어디서나 작동합니다. 항상 있어야 하는 맥락에는 프로젝트를, 반복하는 작업에는 skill을 사용하세요.
직접 작성하고 싶지 않으신가요?
이미 작성하고 테스트한 Skills, prompts 및 agents 2,400개 이상.
Claude, ChatGPT 및 모든 AI 채팅에서 사용할 수 있는 역할별 skill 파일 - 회계 담당자, SEO 전략가, 의료 기록 작성자, 플랫폼 엔지니어용입니다. GitHub에서 긁어온 것이 아니라 저희가 직접 작성하고 테스트했습니다. 다운로드하여 폴더에 넣으면 끝입니다. 구독 없이 한 번만 결제하면 됩니다.