클로드 코드 스킬은 SKILL.md 파일 하나에 적어 둔 작업 지침으로, Claude가 필요할 때 알아서 꺼내 쓰거나 /스킬이름으로 직접 부릅니다. 내 컴퓨터의 ~/.claude/skills 폴더나 프로젝트의 .claude/skills 폴더에 두면 됩니다.
공식 모음은 Anthropic의 GitHub 저장소 anthropics/skills와 공식 플러그인 마켓플레이스에 있습니다. Claude Code 공식 문서와 Claude 도움말을 2026년 10월 16일에 직접 읽고 정리했습니다.
1. 클로드 코드 스킬이란 무엇인가요?
반복하는 일을 적어 둔 지침 폴더입니다. 공식 문서는 같은 지침이나 체크리스트, 여러 단계 절차를 채팅에 자꾸 붙여넣게 될 때 스킬을 만들라고 안내합니다.
스킬 본문은 쓸 때만 불러와서 긴 참고 자료를 넣어 둬도 평소에는 거의 부담이 없습니다. 예전의 사용자 정의 명령(.claude/commands/)도 스킬로 합쳐졌고, 그 파일들은 그대로 작동합니다.
Claude 도움말은 스킬을 이렇게 설명합니다.
누구나 Markdown으로 지침을 작성하여 스킬을 만들 수 있습니다.
간단한 스킬은 코딩이 필요 없고, 더 복잡한 일에는 스크립트 파일을 함께 넣을 수 있습니다. 클로드 코드에는 /doctor, /code-review, /debug 같은 기본 스킬도 들어 있습니다.
2. 스킬을 두는 폴더
어느 폴더에 두느냐가 어디서 쓰이는지를 정합니다. 모든 프로젝트에서 쓰려면 내 컴퓨터의 ~/.claude/skills/스킬이름/SKILL.md에 둡니다. 윈도우에서는 %USERPROFILE%\.claude\skills\스킬이름\SKILL.md입니다.
한 프로젝트에서만 쓰려면 그 프로젝트 폴더 안 .claude/skills/스킬이름/SKILL.md에 둡니다. 프로젝트와 함께 저장소에 올리면 같은 저장소에서 일하는 팀원도 쓸 수 있습니다.
같은 이름이 두 곳에 있으면 개인 폴더 쪽이 프로젝트보다 먼저입니다. 플러그인으로 설치한 스킬은 /플러그인이름:스킬이름으로 불러서 이름이 겹치지 않습니다.
3. SKILL.md는 이렇게 생겼습니다
SKILL.md는 두 부분입니다. 맨 위 --- 두 줄 사이의 머리말(frontmatter)에는 언제 쓸지를, 그 아래 본문에는 스킬이 실행될 때 따를 지침을 적습니다.
name:/메뉴에 뜨는 이름. 비우면 폴더 이름description: 무엇을 하고 언제 쓰는지. Claude가 이 문장을 보고 스킬을 쓸지 정하므로 넣기를 권장- 본문: 순서, 체크리스트, 지켜야 할 규칙
설명에는 핵심 쓰임새를 앞에 둡니다. 스킬 목록에서 description과 when_to_use를 합쳐 1,536자에서 잘리기 때문입니다. 저절로 불리지 않게 하려면 disable-model-invocation: true를 넣습니다.
4. 처음 스킬을 만드는 순서
- 개인 스킬 폴더 안에 스킬 이름으로 폴더를 하나 만든다
- 그 안에 SKILL.md를 만들고 머리말과 본문을 적는다
claude를 실행해/스킬이름으로 부르거나, 설명에 맞는 요청을 한다/skills로 목록에 떴는지 확인한다
공식 예시는 맥·리눅스 터미널에서 mkdir -p ~/.claude/skills/summarize-changes로 폴더를 만들고, /summarize-changes로 부르거나 「What did I change?」라고 물어 시험합니다.
스킬은 정해진 폴더에 SKILL.md 한 장만 두면 바로 쓸 수 있고, 클로드 코드를 켜기 전부터 있던 skills 폴더라면 고친 내용도 다시 시작하지 않아도 반영됩니다.
클로드 코드를 켜 둔 채 skills 폴더를 처음 만들었다면 /reload-skills를 입력해야 스킬을 읽습니다. 그 세션에서는 그 폴더를 감시하지 않아, 고칠 때마다 다시 입력하라고 공식 문서에 적혀 있습니다.
명령어가 낯설다면 클로드 코드에 how do I create custom skills in Claude Code?라고 물어봐도 됩니다. 공식 빠른 시작 문서에 실린 예시 질문입니다.
5. 공식 스킬 모음은 어디에 있나요
Anthropic은 GitHub에 anthropics/skills라는 스킬 저장소를 공개해 두었습니다. 클로드 코드 안에서 /plugin marketplace add anthropics/skills를 입력하면 이 저장소를 설치 목록으로 추가할 수 있습니다.
저장소 안내문에 따르면 그다음 /plugin install document-skills@anthropic-agent-skills로 문서 스킬 묶음을, /plugin install example-skills@anthropic-agent-skills로 예제 묶음을 설치합니다.
Word·PDF·PowerPoint·Excel 스킬은 오픈소스가 아닌 소스 공개 형태입니다.
Anthropic 공식 플러그인 마켓플레이스 claude-plugins-official은 클로드 코드를 처음 실행할 때 자동으로 추가됩니다. /plugin의 Discover 탭에서 검색하거나 웹의 Claude Marketplace에서 전체 목록을 볼 수 있습니다.
6. 설치 전에 확인할 것
공식 문서는 설치한 플러그인이 내 사용자 권한으로 아무 코드나 실행할 수 있다고 경고합니다. 스킬도 Claude가 따르는 지침으로 들어가 Claude의 행동에 영향을 줍니다.
마켓플레이스 이름은 누가 목록을 냈는지만 알려 줄 뿐이라, 어디서 받든 설치 전에 내용을 확인하라고 공식 문서는 안내합니다. Anthropic은 다른 회사·개인이 운영하는 마켓플레이스는 검토하지 않는다고 밝혔습니다.
anthropics/skills 저장소의 스킬도 시연과 교육용이라고 적혀 있습니다. 중요한 일에 쓰기 전에는 내 환경에서 충분히 시험해 보라는 것이 저장소의 안내입니다.
7. 무료 플랜에서도 스킬을 쓸 수 있나요
claude.ai 채팅에서는 됩니다. Claude 도움말은 스킬을 Free부터 Enterprise까지 모든 플랜에서 쓸 수 있고 코드 실행을 켜야 한다고 적었습니다. 다만 클로드 코드 자체는 Pro 이상 유료 플랜이나 Console 계정이 필요합니다.
claude.ai 계정에 켜 둔 스킬은 같은 계정으로 로그인한 클로드 코드 터미널 세션에도 동기화됩니다. 설치와 첫 실행은 클로드 코드 터미널(CLI) 처음 쓰는 법에 정리했습니다.
요금은 클로드 코드 요금제, 무료로 쓸 수 있을까?를, 다른 AI 코딩 도구와의 비교는 AI 코딩 도구 총정리, 2026년 요금과 고르는 법을 참고하세요.
참고자료 (모두 2026년 10월 16일 확인)
- Claude Code 문서 「skills로 확장하기」 — code.claude.com/docs/ko/skills
- Claude Code 문서 「Anthropic's marketplaces」·「Plugin security and trust」 — code.claude.com/docs
- Claude 도움말 「스킬이란 무엇인가요?」 — support.claude.com
- Anthropic 공식 스킬 저장소 — github.com/anthropics/skills
- Claude Marketplace — claude.com/marketplace/plugins
#클로드코드 #클로드코드스킬 #ClaudeCode #SKILLmd #AI코딩도구
