클로드 스킬(Claude Skills) 사용법과 만드는 법

주간 보고서, 출장비 정산서, 고객 답장처럼 매주 비슷한 일을 클로드에게 맡길 때마다 지난번에 쓴 긴 지시를 찾아 다시 붙여 넣고 있다면, 클로드 공식 문서는 그 지시를 스킬로 만들어 두라고 안내합니다. 이 글은 회사 공용 폴더에 모아 둔 업무 양식과 클로드 스킬을 나란히 놓고, 스킬을 쓰는 이유와 켜는 법, 만드는 법을 차례로 설명합니다.

회사 공용 폴더의 업무 양식을 일이 생길 때 꺼내 쓰듯, 클로드 스킬(Claude Skills)은 반복하는 작업의 지침과 참고 파일, 스크립트를 SKILL.md가 든 폴더 하나에 적어 두고, 요청이 그 설명과 맞을 때 클로드가 꺼내 따르게 하는 기능입니다.

클로드는 앤트로픽(Anthropic)이 만든 AI 서비스입니다. 스킬은 웹과 데스크톱의 채팅 앱(claude.ai)에서도, 내 컴퓨터의 파일을 다루는 클로드 코드에서도 씁니다. 아래 장면에서 공용 폴더의 양식과 클로드 스킬을 먼저 비교하고, 본문에서 켜는 법과 만드는 법을 설명합니다.

클로드 스킬은 클로드가 꺼내 쓰는 업무 양식입니다

회사에서는 반복하는 서류를 매번 처음부터 쓰지 않습니다. 공용 폴더에 주간 보고, 출장비 정산서, 고객 답장 양식을 모아 두고, 일이 생기면 파일 이름을 보고 그 일에 맞는 양식 하나만 열어 적힌 순서대로 채웁니다. 폴더에 든 양식을 모두 열어 보지는 않습니다.

클로드 스킬도 같은 방식으로 씁니다. 작업 순서를 스킬로 적어 두면 클로드는 평소 스킬마다 붙은 설명 한 줄만 보고 있다가, 요청이 어떤 스킬의 설명과 맞으면 그 스킬 하나만 읽고 적힌 순서대로 일합니다. 맞는 스킬이 없으면 스킬을 읽지 않고 평소처럼 답합니다. 다른 점은 누가 고르는지입니다. 공용 폴더에서는 사람이 양식을 고릅니다. 스킬은 클로드가 요청을 보고 고릅니다.

클로드 공식 문서는 스킬을 "==Skills are directories containing instructions, scripts, and resources that Claude dynamically loads to handle specific tasks=="라고 정의합니다. 스킬은 클로드가 특정 작업을 처리할 때 필요에 따라 불러오는 지침, 스크립트, 자료를 담은 폴더라는 뜻입니다.

같은 지시를 붙여 넣는 대신 스킬로 저장하는 이유

클로드 코드 스킬 문서는 스킬을 만들 때를 이렇게 적습니다. "==Create a skill when you keep pasting the same instructions, checklist, or multi-step procedure into chat==". 같은 지시, 확인 목록, 여러 단계로 된 절차를 대화에 계속 붙여 넣고 있다면 스킬을 만들라는 뜻입니다.

지시를 매주 붙여 넣으면 붙여 넣는 양이 계속 쌓이고, 한 줄을 빠뜨린 주에는 그 줄이 지켜지지 않은 결과를 받습니다. 위 장면의 3주차가 그런 경우입니다. 스킬로 저장해 두면 지시는 첫 주에 한 번 적고, 다음 주부터는 "이번 주 주간 보고서를 정리해 주세요"처럼 짧게 요청해도 요청이 스킬 설명과 맞을 때 클로드가 저장한 지시를 같은 내용으로 읽습니다.

스킬은 모든 대화에 들어가지도 않습니다. 같은 문서는 "Unlike CLAUDE.md content, a skill's body loads only when it's used"라고 적습니다. CLAUDE.md는 클로드 코드가 세션(클로드 코드를 한 번 실행해 이어 가는 작업 단위)을 시작할 때마다 읽는 저장소 규칙 파일인데, 이 파일과 달리 스킬 본문은 쓸 때만 대화에 들어간다는 뜻입니다. 그래서 스킬을 여러 개 켜 두어도 관계없는 대화에는 그 본문이 끼어들지 않습니다. 반대로 한 번만 할 일은 스킬로 만들지 않고 대화에 바로 적는 편이 낫습니다.

스킬 폴더의 구조: SKILL.md와 클로드가 스킬을 세 단계로 나눠 읽는 순서

스킬 하나는 폴더 하나입니다. 폴더 안에는 반드시 SKILL.md 파일이 있고, 필요하면 참고 문서, 양식 파일, 실행할 코드를 함께 넣습니다. SKILL.md 맨 위 머리말에는 스킬의 이름(name)과 설명(description)을 적고, 그 아래 본문에 작업 순서를 적습니다. 도입부 그림에서 스킬 하나를 뜻하던 판에 붙어 있던 설명 한 줄이 이 description입니다.

클로드는 대화를 시작할 때 모든 스킬을 다 읽지 않습니다. 공식 문서가 설명하는 순서는 세 단계입니다.

1. 목록만 봅니다. 켜 둔 스킬마다 이름과 설명(description) 한 줄만 봅니다.
2. 맞는 스킬의 본문을 읽습니다. 요청이 어떤 스킬의 설명과 맞으면 그 스킬의 SKILL.md 본문을 읽습니다.
3. 필요한 파일만 엽니다. 본문의 단계가 참고 문서나 스크립트를 가리킬 때 그 파일을 엽니다.

같은 문서는 "A skill's description matters because it's the only part Claude sees before deciding to use the skill"이라고 적습니다. 클로드가 스킬을 쓸지 정하기 전에 보는 부분이 설명 한 줄뿐이라는 뜻입니다. 스킬이 제때 불리는지는 본문보다 설명에 달려 있습니다.

스킬은 만든 주체에 따라 네 가지로 나뉩니다.

스킬 형식은 Agent Skills 공개 표준을 따릅니다. 그래서 클로드용으로 만든 스킬을 이 표준을 쓰는 다른 AI 도구에서도 쓸 수 있습니다.

프로젝트 지침, CLAUDE.md, MCP와 다른 점

아래 기능은 모두 클로드에게 무언가를 알려 주지만, 언제 대화에 들어오는지가 다릅니다.

공식 문서의 구분은 분명합니다. 모든 대화에 쓸 지침은 스킬이 아니라 개인 설정이나 프로젝트 지침에 둡니다. 다른 서비스의 실시간 데이터는 MCP 커넥터가 가져오고, 스킬은 그 커넥터를 어떻게 쓸지 알려 줄 수는 있지만 서비스의 데이터를 직접 가져오지는 못합니다. 클로드 코드 문서는 CLAUDE.md의 한 부분이 사실이 아니라 절차로 길어졌다면 길어진 절차를 스킬로 옮기라고 권합니다. CLAUDE.md는 매 세션 불러오지만 스킬 본문은 쓸 때만 불러오기 때문입니다.

채팅 앱(claude.ai)에서 스킬을 켜고 쓰는 법

채팅 앱의 스킬은 Pro, Max, Team, Enterprise 플랜에서 씁니다. 스킬은 클로드의 코드 실행 환경에서 돌아가므로 코드 실행 기능이 먼저 켜져 있어야 합니다. 메뉴 이름은 2026년 10월 영어 화면 기준입니다.

1. claude.ai에서 Settings > Capabilities를 열고 Code execution and file creation을 켭니다. Team과 Enterprise 플랜은 조직 소유자가 조직 설정에서 켭니다.
2. Customize > Skills를 엽니다. Your skills 탭에는 내가 만든 스킬, 조직이 준 스킬, 공유받은 스킬, 앤트로픽과 파트너 스킬이 나뉘어 보이고, Discover 탭에는 더할 수 있는 스킬이 보입니다.
3. 쓸 스킬의 Turn on을 누릅니다.
4. 대화에서 하려는 일을 그냥 적습니다. 요청이 켜 둔 스킬의 설명과 맞으면 클로드가 그 스킬을 불러옵니다. 직접 고르려면 입력창에 /를 입력하고 스킬을 선택합니다.

엑셀, 워드, 파워포인트, PDF 스킬은 따로 부르지 않아도 됩니다. 코드 실행이 켜져 있으면 "3분기 실적 발표용 파워포인트를 만들어 줘" 같은 요청에서 클로드가 파워포인트 스킬을 알아서 씁니다.

다른 사람이 공유한 스킬과 내가 올린 스킬은 앤트로픽이 검토하지 않습니다. 스킬의 지침과 스크립트는 대화 안에서 실행되므로, 켜기 전에 SKILL.md와 들어 있는 파일을 직접 열어 무엇을 하는지 읽습니다.

클로드 스킬 추천: 앤트로픽이 공개한 스킬부터 봅니다

스킬을 처음 만들 때는 잘 만든 스킬을 먼저 읽어 보는 편이 빠릅니다. 앤트로픽은 공개 스킬 저장소에 실제로 쓰는 스킬을 올려 두었습니다. 2026년 10월 23일 기준 skills 폴더에는 19개가 있습니다. 실무에서 먼저 볼 만한 스킬은 아래와 같습니다.

docx, pdf, pptx, xlsx 네 스킬은 소스를 공개했지만 오픈소스 라이선스(누구나 코드를 고치고 다시 배포하도록 허락하는 사용 조건)는 아닙니다. 나머지 다수는 Apache 2.0 라이선스로, 저작권과 라이선스 문구를 남기면 상업적 사용과 수정, 재배포를 허락합니다. 공식 문서도 남의 스킬은 내용을 그대로 쓰기보다 폴더 구성과 머리말 형식을 본떠 내 지침으로 바꿔 쓰라고 권합니다.

클로드 코드에서는 이 저장소를 플러그인 마켓플레이스(설치할 수 있는 플러그인 목록)로 더한 뒤, 문서 스킬 묶음을 한 번에 설치합니다.

클로드 스킬 만드는 법: SKILL.md 한 파일부터 시작합니다

공식 문서는 같은 지시를 되풀이해 클로드의 결과를 바로잡고 있는 작업, 예를 들어 팀의 보고서 양식, 검토 체크리스트, 여러 단계로 된 절차를 스킬 후보로 꼽습니다.

처음에는 할 일을 한 문장으로 적고, 좋은 결과가 어떤 모습인지 적습니다. 그 한 문장이 description이 되고, 나머지가 본문이 됩니다. 아래는 블로그 초안을 검수하는 스킬의 예입니다.

3번 단계의 references/banned-words.md는 금지 표현 목록을 적어 같은 스킬 폴더에 함께 넣는 참고 파일입니다. 클로드는 이 파일을 3번 단계에 이르렀을 때 엽니다.

머리말(frontmatter)은 파일 맨 위 --- 두 줄 사이에 적는 설정입니다. 채팅 앱에 올리는 스킬은 name과 description이 반드시 있어야 합니다. name에는 소문자, 숫자, 하이픈만 쓰고 64자를 넘기지 않으며, 폴더 이름과 똑같이 맞춥니다.

설명과 본문은 이렇게 씁니다.

• 설명에는 하는 일과 쓰는 때를 함께 적습니다. 사람이 그 일을 맡길 때 실제로 쓰는 낱말(검수, 초안, 발행 전)을 넣어야 요청과 맞습니다. 클로드 코드는 스킬 목록에서 description과 when_to_use(호출 조건과 예시 요청을 따로 적는 머리말 필드)를 합친 글을 1,536자에서 자르므로 핵심 용도를 첫 문장에 둡니다.
• 한 스킬에는 한 가지 일만 담습니다. 여러 일을 섞으면 설명이 넓어져 엉뚱한 요청에 불립니다. 작은 스킬 여러 개는 한 대화에서 함께 쓸 수 있습니다.
• 본문은 500줄 아래로 둡니다. 긴 규칙과 예시는 references/ 같은 폴더로 옮기고, 본문에서 그 자료가 필요한 단계에 파일 경로를 적어 그때 열게 합니다.
• 입력과 출력 예시를 넣습니다. 클로드가 결과 모양을 예시에 맞춥니다.
• 비밀값을 넣지 않습니다. 스킬을 공유받는 사람은 폴더의 파일을 모두 받으므로 API 키나 비밀번호를 넣지 않고, 외부 서비스는 각자 로그인하는 커넥터로 연결합니다.

스크립트를 넣을 때는 본문에 python3 ${CLAUDE_SKILL_DIR}/scripts/check.py처럼 적습니다. 클로드 코드와 Cowork(클로드 데스크톱 앱에서 연결한 폴더와 앱으로 일을 맡기는 기능)는 ${CLAUDE_SKILL_DIR}를 스킬 폴더의 실제 경로로 바꿉니다. 채팅 앱에서는 폴더 전체가 코드 실행 환경으로 복사되므로 scripts/check.py처럼 SKILL.md 기준 경로로도 찾을 수 있게 둡니다.

채팅 앱에 올리기: 폴더째 ZIP으로 묶습니다

채팅 앱에는 스킬 폴더를 ZIP 파일로 묶어 올립니다. ZIP을 열었을 때 맨 위에 스킬 폴더가 있어야 하고, SKILL.md만 맨 위에 있으면 스킬로 인식하지 않습니다. 맥에서는 스킬 폴더가 든 상위 폴더에서 아래 명령으로 묶고, 두 번째 명령(unzip -l)이 보여 주는 ZIP 안 파일 목록의 모든 항목이 blog-draft-check/로 시작하는지 봅니다.

ZIP을 만들었으면 Customize > Skills에서 + 버튼, + Create skill, Upload a skill 순서로 올리고 켭니다. 올린 스킬은 공유하기 전까지 동료에게 보이지 않습니다. 켠 뒤에는 새 대화에서 "이 초안을 발행 전에 검수해 줘"처럼 설명과 맞는 요청을 보내고, 답변 위에 접혀 보이는 작업 과정(클로드가 연 파일과 실행한 단계를 보여 주는 부분)을 펼쳐 스킬의 SKILL.md를 읽었는지 봅니다. 불리지 않으면 설명을 고칩니다.

클로드 코드에 두기: 폴더 위치가 쓰는 범위를 정합니다

클로드 코드에서는 ZIP 없이 폴더를 정해진 위치에 두면 됩니다. 폴더 이름(또는 머리말의 name)이 그대로 / 명령 이름이 됩니다.

같은 이름이 개인 폴더와 프로젝트 폴더에 함께 있으면 개인 스킬이 쓰입니다. 개인 폴더의 스킬은 Cowork와 클라우드 세션, 클라우드 예약 작업(정해 둔 시각에 클라우드에서 실행되는 작업)에서 불러오지 않습니다. 이 세 환경에서 쓰려면 스킬을 claude.ai 계정에 올려 켜고, 클라우드 세션이라면 저장소의 .claude/skills/에 커밋해도 됩니다. 다만 클로드 코드 Projects에서 클라우드로 실행하는 작업 스레드는 저장소의 스킬을 불러오지 않고 계정 스킬만 씁니다. 예전에 .claude/commands/에 두던 사용자 지정 명령은 스킬로 합쳐졌습니다. .claude/commands/deploy.md와 .claude/skills/deploy/SKILL.md는 둘 다 /deploy를 만들고, 기존 명령 파일도 계속 동작합니다. 새로 만들 때는 참고 파일을 함께 둘 수 있는 스킬 폴더를 씁니다.

클로드 코드는 스킬 폴더를 지켜보고 있어서 SKILL.md를 고치면 재시작하지 않아도 반영합니다. 세션을 시작한 뒤에 최상위 skills 폴더를 처음 만들었다면 /reload-skills를 입력합니다. 이미 불린 스킬은 대화에 들어온 옛 본문이 그대로 남으므로, 고친 뒤에는 스킬을 다시 부릅니다.

대화로 만들기: skill-creator에게 초안을 맡깁니다

직접 쓰기 어렵다면 앤트로픽의 skill-creator 스킬에게 초안을 맡기고 결과를 고칩니다. 채팅 앱에서는 Customize > Skills에서 skill-creator를 켜고 "매주 쓰는 광고 보고서 절차를 스킬로 만들어 줘"라고 요청합니다. skill-creator는 채팅 앱에서는 시험 요청을 하나씩 돌려 결과를 보여 줍니다. Cowork와 클로드 코드에서는 스킬이 없을 때와 있을 때를 함께 돌려 통과율, 시간, 토큰(AI가 글을 나눠 처리하는 단위) 수를 비교합니다. 클로드 코드에서는 플러그인으로 설치합니다.

광고 보고서 스킬의 SKILL.md를 한 칸씩 채워 보는 과정은 마케터를 위한 클로드 활용에서 볼 수 있습니다.

스킬은 설명을 보고 자동으로 부르거나 슬래시로 직접 부릅니다

기본으로는 사람과 클로드 모두 스킬을 부를 수 있습니다. 클로드는 요청이 설명과 맞으면 스스로 부르고, 사람은 채팅 앱에서 /를 입력해 고르거나 클로드 코드에서 /blog-draft-check처럼 이름을 입력합니다. 클로드 코드에서는 머리말의 두 필드로 이 방식을 바꿉니다.

disable-model-invocation: true는 배포, 커밋, 메시지 발송처럼 실행 시점을 사람이 정해야 하는 스킬에 넣습니다. 공식 문서는 코드가 준비돼 보인다는 이유로 클로드가 스스로 배포를 결정하면 곤란하다는 예를 듭니다. user-invocable: false는 명령으로 실행할 일이 아닌 배경 지식, 예를 들어 옛 시스템의 구조 설명을 담은 스킬에 넣습니다.

클로드 코드에서 스킬 이름은 메시지 맨 앞에 적어야 바로 실행됩니다. /deploy staging은 바로 실행되지만, 이제 /deploy 해 줘처럼 문장 중간에 적은 이름은 그 메시지에서 스킬을 써도 된다는 허락으로만 받아들여집니다. 터미널 입력창에서는 /write-tests /fix-issue 123처럼 맨 앞에 여러 스킬을 이어 적어 함께 부를 수 있고, 첫 스킬과 그 뒤 다섯 개까지 본문이 대화에 들어옵니다.

클로드 코드에서만 쓰는 머리말 필드가 있습니다

클로드 코드는 공개 표준보다 많은 머리말 필드를 받습니다. 모든 필드는 선택이고 description만 권장입니다. 자주 쓰는 필드는 아래와 같습니다.

여기서 주의할 점은 채팅 앱 업로드입니다. claude.ai에 올리는 스킬과 API로 올리는 스킬(Skills API)은 name, description, license, compatibility, metadata, allowed-tools 여섯 필드만 받습니다. 다른 필드가 있으면 필드를 무시하지 않고 Unexpected key(s) in SKILL.md frontmatter 오류로 업로드가 막힙니다. 클로드 코드에서 만든 스킬을 채팅 앱에서도 쓸 계획이라면 머리말을 이 여섯 필드 안에서 씁니다. allowed-tools는 도구를 막는 설정이 아니라 미리 허락하는 설정이므로, 남이 만든 저장소의 스킬은 이 필드와 실행할 스크립트를 먼저 읽습니다.

스킬이 불리지 않거나 너무 자주 불릴 때

스킬이 불렸다는 것은 클로드가 스킬을 찾았다는 뜻일 뿐, 결과가 좋아졌다는 뜻은 아닙니다. 공식 문서는 새 세션에서 같은 요청을 스킬을 켠 상태와 끈 상태로 각각 보내 결과를 비교하라고 권합니다. 스킬을 만들던 대화를 이어서 시험하면 앞의 대화 내용이 빠진 지침을 채워 주므로 새 세션에서 시험합니다.

한 번 불린 스킬은 대화에 남습니다

도입부에서 본 것처럼 클로드는 요청이 설명과 맞을 때만 스킬 본문을 읽고, 한 번 읽은 본문은 이후 메시지에도 대화에 남습니다. 클로드 코드는 스킬 파일을 다시 읽지 않으므로 본문은 "다음 단계에서 테스트를 돌린다"보다 "고칠 때마다 테스트를 돌린다"처럼 작업 내내 지킬 지침으로 씁니다. 대화가 길어져 자동 요약이 실행되면 CLAUDE.md는 다시 읽어 넣지만, 불렸던 스킬은 스킬마다 앞 5,000토큰까지, 모두 합쳐 25,000토큰 안에서만 다시 붙습니다. 그래서 가장 중요한 지침은 본문 앞쪽에 둡니다.

자주 묻는 질문

스킬과 프로젝트는 무엇이 다른가요?

프로젝트 지침은 그 프로젝트의 모든 대화에 늘 들어가고, 스킬은 요청이 설명과 맞을 때만 들어갑니다. 그래서 회사 소개처럼 늘 알아야 할 배경은 프로젝트에, 주간 보고서 절차처럼 특정 일에만 필요한 순서는 스킬에 둡니다.

클로드 코드에서 만든 스킬을 claude.ai에도 올릴 수 있나요?

머리말이 공개 표준의 여섯 필드(name, description, license, compatibility, metadata, allowed-tools) 안에 있으면 ZIP으로 묶어 올릴 수 있습니다. disable-model-invocation이나 context 같은 클로드 코드 전용 필드가 있으면 업로드에서 오류가 납니다. 본문에 쓴 클로드 코드 전용 기능, 예를 들어 명령 결과를 끼워 넣는 문법은 채팅 앱에서 동작하지 않습니다.

스킬 여러 개를 한 번에 부를 수 있나요?

클로드 코드의 터미널 입력창에서는 메시지 맨 앞에 /write-tests /fix-issue 123처럼 이어 적어 함께 부를 수 있고, 첫 스킬과 그 뒤 다섯 개까지 본문이 대화에 들어옵니다. 자동 호출에서도 클로드는 한 대화에서 여러 스킬을 쓸 수 있으므로, 큰 스킬 하나보다 작은 스킬 여러 개가 잘 맞물립니다.

남이 만든 스킬을 그대로 켜도 되나요?

켜기 전에 SKILL.md와 스크립트를 직접 읽어야 합니다. 공유받은 스킬과 직접 올린 스킬은 앤트로픽이 검토하지 않고, 스킬의 지침과 스크립트는 대화 안에서 실행됩니다. 클로드 코드에서는 저장소에 들어 있는 스킬의 allowed-tools가 어떤 도구를 미리 허락하는지도 봅니다.

마무리: 스킬로 만들 일과 만들지 않을 일

• 스킬로 만들 일: 같은 지시와 확인 목록을 매번 다시 붙여 넣는 일, 정해진 양식으로 반복하는 일입니다.
• 다른 기능에 맡길 일: 모든 대화에 쓸 규칙은 프로젝트 지침이나 CLAUDE.md에, 외부 서비스의 최신 데이터는 MCP 커넥터에 둡니다.
• 불리는지 확인할 점: 설명 첫 문장이 하는 일과 쓰는 때를 요청 낱말로 담고 있는지 봅니다.
• 부르는 사람 정하기: 메시지 발송과 배포처럼 되돌리기 어려운 스킬은 사람만 부르게 합니다.

지금 해 볼 수 있는 일은 세 가지입니다.

• claude.ai의 Customize > Skills에서 켜 둔 스킬과 Discover 탭의 스킬을 훑어봅니다.
• 이번 주에 두 번 이상 같은 지시를 붙여 넣은 작업 하나를 골라 description 한 문장을 적어 봅니다.
• 앤트로픽 공개 스킬 저장소에서 brand-guidelines의 SKILL.md를 열어 머리말과 본문을 내 스킬 초안과 비교합니다.

참고 자료

• 클로드 문서: Skills overview
• 클로드 문서: Create custom skills
• Claude 도움말: Use skills in Claude
• Claude 도움말: How to create custom skills
• 클로드 코드 문서: Extend Claude with skills
• 앤트로픽 공개 스킬 저장소
• Agent Skills 공개 표준