클로드 스킬은 "이 작업은 이렇게 하라"는 절차를 폴더 하나에 담아 두면, Claude가 관련 작업을 할 때 알아서 꺼내 쓰는 기능입니다. 결론부터 말하면 무료 요금제에서도 코드 실행만 켜면 바로 쓸 수 있고, 같은 설명을 매번 붙여 넣고 있다면 그 설명을 SKILL.md 하나로 옮기는 것이 시작입니다. 이 글은 2026년 10월 12일 기준 공식 도움말(support.claude.com)과 클로드 코드 문서를 바탕으로 했고, 지금 읽고 계신 이 블로그의 글도 직접 만든 클로드 스킬로 작성합니다.
클로드 스킬은 무엇인가요?
공식 설명으로는 "지침, 스크립트, 자료를 담은 폴더"입니다. 핵심은 필요할 때만 불러온다는 점입니다. Claude는 평소에 각 스킬의 이름과 설명만 알고 있다가, 요청이 그 설명과 맞으면 그때 본문을 읽습니다. 공식 문서는 이를 점진적 공개(progressive disclosure)라고 부르고, 덕분에 스킬을 여러 개 켜 둬도 대화 길이(컨텍스트)를 크게 잡아먹지 않습니다.
스킬은 세 종류로 나뉩니다.
- Anthropic 기본 스킬: 엑셀, 워드, 파워포인트, PDF 만들기. 켜 두면 "3분기 실적 발표 자료 만들어 줘" 같은 요청에 Claude가 알아서 씁니다.
- 내가 만든 스킬: 회사 문서 양식, 보고서 순서, 반복 업무 절차처럼 나만의 방식을 담습니다.
- 파트너·조직 스킬: 노션·피그마 같은 회사가 만든 스킬이나, 회사 관리자가 전 직원에게 배포한 스킬입니다.
스킬 형식은 agentskills.io 에 오픈 표준으로 공개돼 있어서, 같은 형식을 지원하는 다른 도구에서도 쓸 수 있습니다.
클로드 스킬과 프로젝트·MCP는 무엇이 다른가요?
비슷해 보이는 기능이 여럿이라 헷갈리기 쉽습니다. 공식 도움말의 구분을 표로 옮기면 이렇습니다.
| 기능 | 담는 것 | 불러오는 때 | 이런 경우에 |
|---|---|---|---|
| 스킬 | 작업 절차, 예시, 스크립트 | 관련 작업일 때만, 어느 대화에서나 | 같은 작업을 같은 방식으로 반복할 때 |
| 프로젝트 | 배경 자료, 지침 | 그 프로젝트 안 대화마다 항상 | 한 주제의 자료를 계속 참고할 때 |
| MCP | 외부 서비스 연결(도구) | 도구를 부를 때 | 노션·DB·DNS를 Claude가 직접 다뤄야 할 때 |
| 맞춤 지침 | 말투·선호 같은 전반 규칙 | 모든 대화 | 늘 적용할 짧은 규칙 |
자료 묶음이 필요하면 클로드 프로젝트 사용법을, 외부 서비스 연결이 필요하면 클로드 MCP 연결 방법을 먼저 보세요. 공식 도움말 표현대로 MCP가 도구를 주고, 스킬은 그 도구를 잘 쓰는 법을 가르치는 관계라 둘을 같이 쓰는 경우가 많습니다.
claude.ai에서 클로드 스킬을 켜려면 어떻게 하나요?
스킬은 Free·Pro·Max·Team·Enterprise 모든 요금제에서 쓸 수 있습니다. 조건은 하나, 코드 실행이 켜져 있어야 합니다.
- Settings > Capabilities 에서 코드 실행 및 파일 생성(Code execution and file creation) 을 켭니다.
- Customize > Skills 로 갑니다.
- 쓰고 싶은 스킬을 켜고 끕니다. 기본 스킬은 켜 두기만 하면 Claude가 필요할 때 씁니다.
Team은 조직 단위로 기본 허용돼 있고, Enterprise는 Owner가 Organization settings > Plugins & skills 의 Policy 탭에서 코드 실행과 스킬을 둘 다 켜 줘야 구성원이 쓸 수 있습니다.
내가 만든 스킬은 어떻게 설치하나요?
스킬 폴더를 ZIP으로 압축해 Customize > Skills 의 '+' → 'Create skill' → 'Upload a skill' 로 올립니다. 이때 ZIP을 열었을 때 맨 위에 파일이 바로 보이면 안 되고, 스킬 폴더가 최상위에 있어야 합니다. 폴더 이름은 스킬 이름과 맞춥니다.
올린 스킬은 나만 봅니다. Team·Enterprise에서는 특정 동료에게 공유하거나(받은 사람은 보기·사용만 가능) 조직 라이브러리에 게시할 수 있습니다.
팁
Pro·Max·Team 요금제라면 Mac용 Claude의 Cowork에서 화면을 녹화해 스킬을 만드는 방법도 있습니다. 약 10분까지 녹화되고, 말로 설명하면서 작업하면 Claude가 스킬 초안을 제안합니다. 채팅 화면, Windows, 무료·Enterprise 요금제에서는 안 됩니다.
클로드 코드에서는 스킬을 어떻게 쓰나요?
클로드 코드는 업로드가 필요 없습니다. 정해진 위치에 폴더를 두면 끝입니다.
| 범위 | 위치 | 적용되는 곳 |
|---|---|---|
| 개인 | ~/.claude/skills/스킬이름/SKILL.md |
내 컴퓨터의 모든 프로젝트 |
| 프로젝트 | .claude/skills/스킬이름/SKILL.md |
이 저장소(커밋하면 팀 공유) |
| 플러그인 | 플러그인/skills/스킬이름/SKILL.md |
플러그인을 켠 곳, /플러그인:스킬 로 호출 |
부르는 방법은 두 가지입니다. 요청이 description과 맞으면 Claude가 알아서 불러오고, 직접 쓰고 싶으면 /스킬이름 을 입력합니다. 배포처럼 함부로 실행되면 곤란한 스킬은 머리말에 disable-model-invocation: true 를 넣어 내가 부를 때만 돌게 합니다. 여러 스킬과 MCP 서버를 묶은 플러그인은 /plugin 에서 설치합니다. 클로드 코드 자체가 처음이라면 클로드 코드 사용법부터 보세요.
이 블로그의 글도 이렇게 만든 프로젝트 스킬(mjblog-write)로 씁니다. 키워드 검색량 조사 → 공식 문서 확인 → 초안 작성 → 표지·본문 그림 렌더 → SEO 검사까지 한 절차로 묶어 두고, 결과는 초안으로만 올려 사람이 검토합니다.
SKILL.md는 어떻게 직접 만드나요?
간단한 스킬은 코드 없이 마크다운 파일 하나면 됩니다. 맨 위 --- 사이에 머리말을 쓰고, 그 아래에 절차를 적습니다.
---
name: weekly-report
description: 주간 업무 보고서를 우리 팀 양식으로 정리한다. "주간 보고", "이번 주 정리" 요청에 쓴다.
---
## 순서
1. 이번 주 한 일을 프로젝트별로 묶는다.
2. 각 항목은 "무엇을 · 결과 · 다음 할 일" 한 줄로 쓴다.
3. 막힌 일은 맨 아래 '도움 필요'에 따로 적는다.
## 예시
- 결제 페이지 개편 · 배포 완료 · 다음 주 전환율 확인
만들 때 지킬 것은 공식 문서 기준으로 이렇습니다.
- name은 64자, description은 200자 이내(claude.ai 업로드 기준). description이 언제 쓰는지를 정하므로 가장 공들일 부분입니다.
- 한 스킬에는 한 가지 작업만. 여러 개로 쪼갠 스킬이 큰 스킬 하나보다 잘 맞물립니다.
- 내용이 길어지면
reference.md같은 파일로 빼고 SKILL.md 에서 언급합니다. 클로드 코드 문서는 SKILL.md 를 500줄 이하로 두라고 권합니다. - claude.ai에 올릴 스킬은 머리말에 name·description·license·compatibility·metadata·allowed-tools 만 씁니다. 클로드 코드 전용 키가 섞이면 업로드할 때 오류가 납니다.
클로드 스킬이 안 통하거나 쓰지 않는 게 나은 경우는?
- 코드 실행이 꺼져 있을 때. 스킬은 코드 실행 위에서 돕니다. 회사 정책으로 막혀 있다면 관리자 설정부터 확인해야 합니다.
- description이 모호할 때. "문서 도우미"처럼 쓰면 Claude가 언제 꺼낼지 모릅니다. 실제로 치는 요청 문장을 description에 넣습니다.
- 한 번만 할 작업. 다시 안 할 일이라면 대화에 바로 설명하는 편이 빠릅니다.
- 외부 서비스 접근이 필요할 때. 스킬만으로는 노션이나 DB에 닿지 못합니다. MCP 연결이 먼저입니다.
- 늘 깔려 있어야 하는 자료. 매번 참고할 긴 자료라면 스킬보다 프로젝트 지식이 맞습니다.
클로드 스킬을 쓸 때 보안은 무엇을 조심해야 하나요?
스킬에는 실행되는 스크립트가 들어갈 수 있습니다. 공식 문서의 주의점을 정리하면 이렇습니다.
- 내려받은 스킬은 켜기 전에 파일을 열어 봅니다. 특히 scripts 폴더.
- API 키·비밀번호를 SKILL.md 에 직접 적지 않습니다.
- 클로드 코드는 저장소에 들어 있는 프로젝트 스킬의
allowed-tools를 신뢰하지 않은 폴더에서도 적용합니다. 남의 저장소를 받았다면.claude/skills부터 확인하고, 필요하면 설정에서disableSkillShellExecution으로 스킬 안의 셸 명령 실행을 막습니다. - Enterprise는 업로드된 스킬·플러그인을 검사하는 스캔 기능을 켤 수 있습니다.
정리: 클로드 스킬은 어떻게 시작하면 될까요?
- 코드 실행을 켜고 기본 스킬(엑셀·워드·PPT·PDF) 부터 써 봅니다.
- 대화창에 매번 붙여 넣는 설명이 있다면 그것을 SKILL.md 하나로 옮깁니다. description에는 실제 요청 문장을 넣습니다.
- claude.ai는 폴더째 ZIP으로 올리고, 클로드 코드는
~/.claude/skills에 둡니다. - 외부 도구가 필요하면 MCP를 붙이고, 남이 만든 스킬은 내용을 읽은 뒤 켭니다.
우리 회사 업무 절차를 스킬과 MCP로 묶어 실제 서비스에 붙이는 일도 웹 개발의 연장입니다.
