클로드 스킬은 Claude에게 일하는 방법을 적어 둔 폴더입니다. 같은 지시를 매번 붙여 넣는 대신 한 번 적어 두면, 관련된 요청이 왔을 때 Claude가 알아서 꺼내 씁니다. 스킬은 무료지만, Claude Code에서 쓰려면 Pro 이상 구독이나 API 결제가 필요합니다. 이 글은 2026년 10월 13일 Claude Code에서 공식 스킬 저장소를 설치하고, 그 안의 skill-creator로 이 사이트의 글 점검 스킬을 만들어 실제 글에 써 본 기록입니다.
직접 실행 확인한 날짜 2026-10-13
- 무엇을 해 주나
- 반복하는 지시·절차를 폴더(SKILL.md)로 저장해 두고, 필요할 때 Claude가 불러 쓰게 함
- 쓸 수 있는 곳
- Claude Code 직접 확인 · Claude 앱(claude.ai)과 API 문서상 지원
- 설치 난이도
- 쉬움 · 1분이면 끝
- 비용
- 스킬 자체는 무료. Claude Code에서 쓰려면 Pro 이상 구독 또는 API 결제 계정 필요
- 라이선스
- 공식 저장소 대부분 Apache 2.0. 문서 스킬(docx·pdf·pptx·xlsx)은 소스 공개, 오픈소스 아님
- 실행 환경
- macOS 26.1 · Claude Code 2.1.292 · 2026-10-13
- 원본
- anthropics/skills (별 약 18만 개, 2026-10-13 확인 · 최근 커밋 2026-10-09)
스킬은 무엇이고 무엇과 다른가
스킬은 SKILL.md 파일 하나가 들어 있는 폴더입니다. 파일 맨 위에는 이름(name)과 설명(description)을 적고, 그 아래에 지시를 씁니다. Claude는 평소에는 이름과 설명만 보고 있다가, 요청이 설명과 맞으면 본문을 읽어 따릅니다. 그래서 스킬이 많아도 평소 대화에 드는 비용이 거의 늘지 않습니다.
| 언제 읽나 | 이럴 때 쓰세요 | |
|---|---|---|
| 스킬 | 관련 요청이 올 때, 또는 /스킬이름으로 부를 때 | 여러 단계짜리 절차, 점검표, 자주 쓰는 작업 방식 |
| CLAUDE.md | 대화를 시작할 때마다 항상 | 프로젝트에서 늘 지킬 짧은 규칙 |
| MCP 서버 | Claude가 외부 도구를 쓸 때 | 노션, 브라우저, 데이터베이스처럼 바깥 서비스와 연결 |
MCP 서버는 Claude가 바깥 서비스나 프로그램을 쓸 수 있게 이어 주는 연결 프로그램입니다.
예전의 사용자 정의 명령(.claude/commands/)은 지금 스킬과 합쳐졌습니다. 공식 문서에 따르면 두 형식 모두 /이름으로 부를 수 있고, 새로 만들 때는 스킬을 권합니다.
스킬을 두는 곳
| 위치 | 경로 | 어디서 쓰이나 |
|---|---|---|
| 개인 | ~/.claude/skills/이름/SKILL.md | 이 컴퓨터의 모든 프로젝트 |
| 프로젝트 | .claude/skills/이름/SKILL.md | 그 폴더(저장소)에서만 |
| 플러그인 | 마켓플레이스에서 설치 | 설치할 때 고른 범위 |
| claude.ai 계정 | 앱에서 켠 스킬 | 같은 계정으로 로그인한 Claude Code |
처음 써 보는 스킬은 프로젝트 범위에 두는 편이 안전합니다. 다른 작업에 섞여 들어가지 않고, 지우기도 쉽습니다. 이번에도 연습용 폴더(skills-lab)를 만들어 그 안에서만 설치했습니다.
1단계. 공식 스킬을 이 폴더에만 설치하기 (약 1분)
이 단계에서는 Anthropic의 공식 스킬 저장소를 플러그인으로 설치합니다. 플러그인은 스킬과 명령 등을 한 번에 설치하는 묶음이고, 마켓플레이스는 그 묶음들의 목록입니다. 저장소에는 스킬이 19개 있고, 플러그인 다섯 묶음으로 나뉩니다. 큰 묶음은 문서 스킬 4개(docx, pdf, pptx, xlsx)가 든 document-skills와, skill-creator·frontend-design 등 12개가 든 example-skills입니다. 이번에는 skill-creator가 필요해서 example-skills를 골랐습니다.
연습 폴더에서 터미널로 실행합니다. --scope local을 붙이면 이 폴더에서만 켜집니다.
claude plugin marketplace add anthropics/skills --scope local
claude plugin install example-skills@anthropic-agent-skills --scope local
이렇게 나오면 성공 Successfully installed plugin: example-skills@anthropic-agent-skills (scope: local)가 나옵니다. 두 명령 모두 몇 초 만에 끝났습니다.
$ claude plugin marketplace add anthropics/skills --scope local
Clone complete, validating marketplace…
✔ Successfully added marketplace: anthropic-agent-skills (declared in local settings)
$ claude plugin install example-skills@anthropic-agent-skills --scope local
✔ Successfully installed plugin: example-skills@anthropic-agent-skills (scope: local)
$ claude plugin validate .claude/skills
✔ Validation passedClaude Code 대화창 안에서는 /plugin marketplace add anthropics/skills를 입력한 뒤 /plugin 화면에서 설치 범위를 고를 수 있습니다. 공식 README의 방법이 이쪽입니다.
marketplace add만 하고 끝내면 스킬이 생기지 않습니다. 마켓플레이스는 목록을 등록하는 것이고,plugin install까지 해야 설치됩니다.
2단계. 다른 폴더에 영향이 없는지 확인하기 (약 1분)
이 단계에서는 정말 이 폴더에서만 켜졌는지 봅니다. 같은 명령을 연습 폴더와 홈 폴더에서 각각 실행했습니다.
claude plugin list
이렇게 나오면 성공 연습 폴더에서는 Status: ✔ enabled, 다른 폴더에서는 Status: ✘ disabled가 나옵니다.
다른 폴더에서도 목록에는 보입니다. 설치 기록은 한곳에 모이고, 켜고 끄는 설정만 폴더별로 따로 들어가기 때문입니다. 설정은 연습 폴더의 .claude/settings.local.json에 적혔습니다.
- 다른 폴더에서도 enabled로 나오면: 설치할 때
--scope local을 빠뜨린 것입니다. 지우고 범위를 붙여 다시 설치합니다.
3단계. skill-creator로 내 스킬 만들기 (약 2분)
이 단계에서는 공식 skill-creator로 이 사이트에 실제로 필요한 스킬을 만듭니다. 이 사이트에는 글을 쓸 때 지키는 기준 문서(writing-guide.md)가 있습니다. 발행 전에 그 기준대로 글을 점검하는 일을 스킬로 맡기기로 했습니다. 연습 폴더에 기준 문서와 첫 글 초안을 넣고, 아래처럼 요청했습니다.
skill-creator 스킬을 사용해서, 이 폴더의 writing-guide.md를 바탕으로 블로그 글을 발행하기 전에 점검하는 스킬을 만들어 줘. 이름은 post-check, 위치는 .claude/skills/post-check/SKILL.md. 이번에는 평가(eval)는 돌리지 말고 SKILL.md 초안만 만들어 줘. 점검 결과는 고칠 것과 괜찮은 것으로 나눠 한국어로 보고하게 해 줘.좋은 답이라면 기준 문서를 읽고, 이름과 설명이 들어간 SKILL.md를 정해 준 위치에 만듭니다. skill-creator는 원래 시험 문제를 만들어 돌려 보는 평가까지 이끄는데, 이번에는 초안만 부탁했습니다.
claude -p --permission-mode acceptEdits로 실행, 2026-10-13초안은 2분쯤 걸려 나왔지만, 정해 준 위치에는 저장되지 않았습니다. 프로젝트의 .claude/ 폴더는 Claude Code가 보호하는 경로라서, 파일 편집을 자동 승인하는 모드에서도 쓰기 전에 사람에게 묻습니다(공식 권한 문서). 이번에는 -p로 한 번만 묻고 끝내는 방식이라 승인할 사람이 없었고, Claude는 초안을 임시 폴더에 저장한 뒤 경로를 알려 줬습니다. 안내대로 그 파일을 .claude/skills/post-check/에 직접 옮겼습니다.
- 대화창에서 같은 요청을 하면 쓰기 전에 승인 질문이 나옵니다. “Yes, and allow Claude to edit files in this project’s .claude folder for this session”을 고르면 그 대화 동안은 다시 묻지 않습니다.
4단계. 만들어진 스킬 확인하기 (약 1분)
이 단계에서는 스킬 파일이 제대로 됐는지 봅니다. 터미널에서 실행합니다.
find .claude/skills -type f && head -4 .claude/skills/post-check/SKILL.md
만들어진 SKILL.md는 119줄이었습니다. 기준 문서의 장마다 근거를 단 점검 항목 19개, 보고서 틀, “글만으로 알 수 없는 것은 통과로 처리하지 않는다” 같은 판단 규칙이 들어 있었습니다. 설명에는 “발행 전 점검”, “이 글 올려도 돼?” 같은 실제 요청 문장이 들어가 있어서, 스킬 이름을 말하지 않아도 불리게 되어 있었습니다.
형식에 문제가 없는지는 아래 명령으로 확인할 수 있습니다.
claude plugin validate .claude/skills이렇게 나오면 성공 ✔ Validation passed가 나옵니다. 이번에도 그렇게 나왔습니다.
No such file이 나오면: 3단계에서 초안 파일을 옮기지 않은 것입니다.- 검사에서 오류가 나오면: 파일 맨 위
---사이의 이름·설명 칸(YAML 형식)이 깨진 것입니다. 이 칸이 깨지면/이름으로는 불려도 알아서는 불리지 않습니다. 공식 문서에 따르면claude --debug로 실행하면 읽기 오류가 보입니다.
5단계. 만든 스킬로 실제 글 점검하기 (약 2분)
이 단계에서는 만든 스킬을 이 사이트의 첫 글 클로드 코드 설치 방법에 써 봤습니다. 스킬 이름은 말하지 않고 평소처럼 물었습니다.
drafts/claude-code-install.html 이 글 올려도 돼?좋은 답이라면 post-check 스킬이 불려서, 기준 문서의 항목대로 고칠 것과 괜찮은 것을 나눠 보고합니다.
2분쯤 지나 보고서가 나왔고, 스킬 이름을 말하지 않았는데도 post-check 형식 그대로였습니다. 고칠 것 9개 가운데 중요한 것은 이랬습니다.
- 5단계 첫 질문만 다른 버전(2.1.292)으로 실행돼 있어 나머지(2.1.296)와 어긋난다.
- “무료 요금제로는 못 쓴다”는 안내가 다섯 군데에 반복된다.
- PATH, 홈브루 같은 용어를 처음 나온 자리에서 풀이하지 않았다.
- API 키를 채팅에 붙여 넣지 말라는 안전 안내가 없다.
- 한 단계에 자료화면이 두 장인 곳이 있다.
모두 맞는 지적이었습니다. 연습 폴더에 기준 문서의 일부 근거 파일(content-plan.md)이 없어서 다섯 항목은 “확인 못 함”으로 남겼는데, 짐작으로 통과시키지 않은 점도 기준 문서가 원하던 동작이었습니다.
지적을 반영해 같은 날 첫 글을 고쳤습니다. 겹치는 안내를 정리하고, 용어 풀이와 키·권한 안내를 넣고, 5단계는 이 사이트의 실제 작업 폴더에서 다시 실행한 질문으로 바꿨습니다.
- 스킬이 알아서 안 불리면: 설명(description)에 실제로 쓰는 요청 문장이 들어 있는지 봅니다. 대화창에서 “What skills are available?”라고 물어 목록에 있는지 확인하고, 급하면
/스킬이름으로 직접 부릅니다.
post-check는 지금 이 사이트 작업 폴더의 .claude/skills/에 옮겨 두고, 글을 발행하기 전마다 쓰고 있습니다.
설치한 스킬 지우기
플러그인으로 설치했다면 설치한 범위를 똑같이 붙여 지웁니다. 이번 연습 폴더도 아래 두 명령으로 원래대로 돌렸고, 지운 뒤 플러그인 목록이 설치 전과 같은 것을 확인했습니다.
claude plugin uninstall example-skills@anthropic-agent-skills --scope local
claude plugin marketplace remove anthropic-agent-skills폴더로 둔 스킬은 그 폴더(.claude/skills/이름/)를 지우면 됩니다.
한계와 주의할 점
- 스킬에는 실행 스크립트가 들어 있을 수 있습니다. skill-creator에도 파이썬 스크립트가 여러 개 있었습니다. 남이 만든 스킬은 설치 전에 폴더 안을 먼저 읽어 봅니다.
- 공식 저장소의 문서 스킬(docx·pdf·pptx·xlsx)은 소스만 공개된 것이라, 고쳐서 다시 배포하는 데 제한이 있습니다.
- Claude 앱(claude.ai)에 스킬을 올려 쓰는 방법은 이번에 해 보지 않았습니다. 앱 쪽 메뉴와 조건은 공식 도움말 기준으로 확인하세요.
- skill-creator의 평가(시험 문제를 만들어 반복 실행) 기능은 이번에 돌리지 않았습니다. 돌리면 사용량이 꽤 듭니다.
- 스킬이 원하지 않을 때도 불리면 설명을 더 좁히거나, 직접 부를 때만 쓰도록
disable-model-invocation: true를 넣습니다. - 긴 대화가 압축되면 스킬 앞부분만 남을 수 있습니다. 중요한 규칙은 SKILL.md 위쪽에 두고, 따르지 않으면 스킬을 다시 부릅니다.
대안
| 이름 | 다른 점 | 이럴 때 고르세요 |
|---|---|---|
| 훅(hooks) | Claude의 판단과 상관없이 정해진 때 매번 실행됨 | 파일 저장 전 검사처럼 절대 빠지면 안 되는 일 |
| 프롬프트 그대로 붙여 넣기 | 아무것도 설치하지 않음 | 한두 번만 쓸 지시 |
자주 묻는 질문
클로드 스킬은 어디에 넣어야 하나요?
모든 프로젝트에서 쓰려면 ~/.claude/skills/이름/SKILL.md, 한 프로젝트에서만 쓰려면 그 폴더의 .claude/skills/이름/SKILL.md에 둡니다. 폴더 이름이 곧 /이름 명령이 됩니다.
클로드 스킬과 MCP는 뭐가 다른가요?
스킬은 Claude에게 일하는 방법을 알려 주는 글이고, MCP는 Claude가 바깥 서비스에 접속하게 해 주는 연결입니다. “노션 글을 이런 형식으로 정리해” 같은 일은 MCP로 노션을 연결하고 스킬로 형식을 알려 주는 식으로 같이 씁니다.
anthropics/skills 설치 명령어는 뭔가요?
터미널에서는 claude plugin marketplace add anthropics/skills 다음에 claude plugin install example-skills@anthropic-agent-skills(또는 document-skills)를 실행합니다. 한 폴더에서만 쓰려면 두 명령 모두 --scope local을 붙입니다.
skill-creator는 어떻게 쓰나요?
설치한 뒤 “skill-creator로 ○○하는 스킬을 만들어 줘”라고 하면 됩니다. 무엇을 할 스킬인지, 어디에 저장할지, 결과를 어떤 형식으로 받을지를 같이 말하면 초안이 더 정확합니다.
스킬을 만들었는데 안 불려요
설명(description)에 실제로 하는 요청 문장을 넣습니다. 이번에 만든 post-check는 설명에 “이 글 올려도 돼?”가 들어 있어서, 그 말만으로 불렸습니다.
출처
anthropics/skills 저장소와 README, Claude Code 스킬 문서, 플러그인 설치 문서, 권한 모드 문서 (모두 2026-10-13 확인)