클로드 스킬이란? SKILL.md로 만드는 법과 MCP·플러그인 차이

클로드 스킬(Agent Skills)은 지시문과 스크립트, 참고 자료를 폴더 하나에 담아 두었다가 요청에 맞을 때만 Claude가 꺼내 쓰게 하는 기능이다. 앤트로픽 문서는 스킬을 필요할 때 불러오는 재사용 자원이라고 설명한다. 만들려면 SKILL.md 파일 하나에 이름과 설명, 작업 순서를 적으면 되고, 클로드 코드에서는 폴더에 넣는 것으로 끝난다.

클로드 스킬이란? 같은 부탁을 매번 다시 쓰고 있다면

보고서를 부탁할 때마다 "표는 이 형식으로, 말투는 이렇게, 숫자는 이 순서로"를 다시 적고 있다면 스킬이 필요한 시점이다. 식당 주방에 붙여 둔 레시피 카드를 떠올리면 쉽다. 손님이 올 때마다 요리사에게 조리법을 말로 설명하는 대신, 메뉴별 카드를 꽂아 두면 주문이 들어올 때 해당 카드만 꺼내 본다. 스킬도 같은 방식이라서 Claude는 평소에 카드 제목과 한 줄 설명만 알고 있다가, 요청이 설명과 맞으면 그 카드를 펼친다. 다만 카드에 적은 내용이 틀리거나 모호하면 Claude는 그대로 따르므로, 쓰기 전에 직접 읽고 믿을 수 있는 출처의 것만 써야 한다.

일반 프롬프트와 다른 점은 대화마다 붙여 넣지 않아도 된다는 것이다. 문서는 스킬이 필요할 때 불러와지므로 같은 안내를 대화마다 반복하지 않아도 된다고 설명한다. 앤트로픽이 제공하는 기본 스킬로는 파워포인트, 엑셀, 워드, PDF 문서 작업이 있다. 직접 만든 스킬은 마케터라면 광고 성과 보고서 양식, 브랜드 말투 점검표, 주간 보고 형식 같은 반복 업무에 쓰기 좋다.

스킬은 어떻게 읽히나: 3단계로 나눠 불러온다

스킬은 한 번에 전부 읽히지 않는다. 문서는 이를 점진적 공개라고 부르며, 아래 표처럼 단계마다 읽는 시점이 다르다.

단계	언제 읽나	토큰 비용	내용
1단계 이름·설명	항상(시작할 때)	스킬당 약 100토큰	SKILL.md 맨 위의 name, description
2단계 본문	스킬이 선택됐을 때	5천 토큰 미만	SKILL.md 본문의 작업 순서와 지침
3단계 보조 자료	필요할 때만	읽기 전까지 0	참고 문서, 템플릿, 스크립트

이 구조 덕분에 스킬을 많이 설치해도 대화창이 무거워지지 않는다. 사용량이 빨리 줄어 고민이라면 클로드 코드 토큰 사용량을 줄이는 법도 함께 보면 좋다. 문서에 따르면 스킬이 선택되기 전에는 이름과 설명만 문맥을 차지한다. 그래서 description을 "무엇을 하고, 언제 쓰는지" 두 가지가 모두 보이게 쓰는 것이 스킬이 제때 불리는 조건이다.

클로드 스킬 vs MCP 커넥터 vs 플러그인: 무엇을 고르나

셋은 경쟁 관계가 아니라 맡은 역할이 다르다. 허브스팟은 스킬은 절차, MCP 커넥터는 접근, 플러그인은 배포를 맡는다고 정리한다.

구분	역할	이럴 때 고른다
스킬	작업 순서·형식·말투를 정한다	반복 업무에 같은 절차를 적용할 때
MCP 커넥터	외부 서비스(파일, 일정, CRM 등)에 연결한다	대화 안에 없는 실시간 데이터가 필요할 때
플러그인	스킬·커넥터·명령어를 한 묶음으로 설치하게 한다	여러 사람이 같은 구성을 한 번에 써야 할 때

예를 들어 주간 영업 점검이라면 커넥터가 CRM에서 거래 현황을 가져오고, 스킬이 어떤 항목을 어떤 형식으로 정리할지 정하며, 플러그인이 둘을 팀원에게 한 번에 나눠 준다. 허브스팟 글은 문제를 해결하는 가장 작은 단위부터 시작하라고 권한다. 처음에는 스킬 하나만 만들고, 데이터 연결이 필요해질 때 커넥터를 더하는 순서가 무난하다.

클로드 코드에서 스킬 만드는 법

클로드 코드에서는 파일 시스템에 폴더를 만들면 그것이 스킬이다. 클로드 코드를 아직 설치하지 않았다면 클로드 코드 설치와 요금제부터 따라 한다. 클로드 코드 문서가 안내하는 위치는 다음과 같다.

범위	경로	적용 대상
개인	~/.claude/skills/<스킬 이름>/SKILL.md	이 컴퓨터의 모든 프로젝트
프로젝트	.claude/skills/<스킬 이름>/SKILL.md	해당 저장소(커밋하면 팀과 공유)

1. 터미널에서 폴더를 만든다. 예: mkdir -p ~/.claude/skills/summarize-changes
2. 그 안에 SKILL.md를 만들고, 맨 위에 ---로 감싼 설명 블록을 적는다. 문서의 예시는 description: 커밋되지 않은 변경 사항을 요약하고 위험 요소를 표시한다. 사용자가 변경 내용을 묻거나 커밋 메시지를 요청할 때 사용한다.처럼 "무엇을 하는지"와 "언제 쓰는지"를 함께 적는다.
3. 설명 블록 아래에 Claude가 따를 순서를 마크다운으로 쓴다. 예: "변경 사항을 2~3개 항목으로 요약하고, 누락된 에러 처리와 하드코딩된 값을 표시한다."
4. 보조 파일(reference.md, scripts/)이 필요하면 같은 폴더에 두고 SKILL.md에서 링크한다. 문서는 SKILL.md를 500줄 이하로 유지하라고 권한다.

이름 규칙도 있다. 플랫폼 문서에 따르면 name은 64자 이하의 소문자·숫자·하이픈만 쓰고, description은 1,024자 이하여야 하며 "claude", "anthropic" 같은 예약어는 이름에 넣을 수 없다. 클로드 코드 문서는 name을 생략하면 폴더 이름이 명령 이름이 된다고 안내한다.

제대로 만들어졌는지는 이렇게 확인한다. 클로드 코드에서 /skills를 입력해 목록에 내 스킬이 보이는지 보고, /summarize-changes처럼 이름으로 직접 실행하거나 description에 맞는 질문을 해서 스킬이 불리는지 본다. 세션 중에 SKILL.md를 고치면 자동 반영되지만, 새로 만든 최상위 skills 폴더는 /reload-skills로 인식시켜야 한다. 배포처럼 부작용이 있는 작업은 frontmatter에 disable-model-invocation: true를 넣어 사용자가 직접 부를 때만 실행되게 할 수 있다.

클로드닷에이아이(웹·앱)에서 스킬 쓰는 법

웹에서는 먼저 코드 실행 기능이 켜져 있어야 한다. 요금제별 한도가 궁금하면 클로드 요금제 가격 비교와 사용량 한도를 먼저 본다. 클로드 도움말에 따르면 개인 요금제는 설정의 Capabilities에서 "Code execution and file creation"을 켜고, 이후 Customize > Skills에서 스킬별로 켜고 끈다. 엑셀·워드·파워포인트·PDF 같은 기본 스킬은 요청에 맞으면 Claude가 알아서 쓰므로 따로 부르지 않는다.

직접 만든 스킬은 폴더를 ZIP으로 압축해 올린다. Customize > Skills에서 "+" 다음 "+ Create skill"을 누르고 "Upload a skill"로 ZIP을 고른다. 올라가지 않으면 도움말이 꼽는 원인을 먼저 본다: 파일 용량 초과, 폴더 이름과 스킬 이름 불일치, skill.md 누락, 이름·설명의 허용되지 않는 문자다. 메뉴 이름은 앱 버전에 따라 Settings > Features로 보일 수 있다.

세 곳의 스킬은 서로 따로 관리된다. 플랫폼 문서는 claude.ai, API, 클로드 코드의 커스텀 스킬이 서로 동기화되지 않는다고 밝힌다. claude.ai는 사용자 개인에게만 적용돼서 팀원은 각자 올려야 하고, API는 워크스페이스 전체가 쓰며, 클로드 코드는 프로젝트 폴더를 커밋해 공유하거나 플러그인으로 배포한다.

스킬을 쓰기 전에 확인할 위험

스킬은 지시문과 코드를 담기 때문에 프로그램을 설치하는 것과 같은 주의가 필요하다. 문서는 직접 만들었거나 앤트로픽에서 받은 것처럼 믿을 수 있는 출처의 스킬만 쓰라고 하며, 악성 스킬은 도구를 오용하거나 데이터를 밖으로 내보낼 수 있다고 경고한다. 인터넷에서 받은 스킬은 SKILL.md뿐 아니라 번들된 스크립트와 외부 주소 호출까지 열어 보고, 설명과 다른 동작이 있는지 확인한 뒤 켠다. 외부 URL에서 내용을 가져오는 스킬은 시간이 지나 내용이 바뀔 수 있어 특히 조심한다.

자주 묻는 질문

클로드 스킬은 무료로 쓸 수 있나?

도움말은 무료 플랜을 포함한 모든 요금제에서 쓸 수 있다고 하지만 코드 실행 기능이 켜져 있어야 한다고 안내한다. 반면 플랫폼 문서는 직접 올리는 커스텀 스킬을 Pro 이상 요금제로 적고 있어, 올리기 전에 내 계정의 Customize 메뉴에서 업로드 항목이 있는지 보는 것이 가장 확실하다.

스킬과 그냥 프롬프트는 무엇이 다른가?

프롬프트는 대화 하나에서만 쓰는 지시이고, 스킬은 저장해 두었다가 요청이 맞을 때 자동으로 불러오는 지시다. 같은 형식을 자주 요구한다면 스킬로 옮기는 편이 낫다.

기존 .claude/commands 파일은 어떻게 되나?

클로드 코드 문서에 따르면 기존 .claude/commands/deploy.md도 /deploy로 계속 동작한다. 스킬은 여기에 보조 파일과 호출 제어를 더한 형태다.