클로드 스킬이란 — 매번 하던 설명을 폴더 하나에
고객센터의 정의부터 옮기면, 스킬은 클로드가 전문적인 일을 더 잘하도록 필요할 때 불러오는 지시 · 스크립트 · 자료의 폴더다. 회사 브랜드 규칙에 맞춘 문서 만들기, 조직의 방식대로 데이터 분석하기, 개인적인 일 처리하기처럼 «정해진 방식이 있는 일»을 매번 같은 품질로 해내게 하는 것이 목적이다.
쓸 수 있는 사람의 폭은 넓다. 스킬은 Free · Pro · Max · Team · Enterprise 모든 플랜에서 쓸 수 있고, 조건은 하나, 코드 실행 기능이 켜져 있어야 한다. 스킬이 클로드의 안전한 격리 실행 환경(샌드박스)에서 돌아가기 때문이다. Claude Code에서도 쓸 수 있고, API에서는 코드 실행 도구를 쓰는 사용자에게 베타로 열려 있다.
스킬은 누가 만들었느냐에 따라 몇 갈래로 나뉜다. 엑셀 · 워드 · 파워포인트 · PDF 파일을 만드는 스킬은 Anthropic이 만들어 관리하며, 모든 사용자가 쓸 수 있고 관련된 요청이면 클로드가 알아서 부른다. 사용자 본인이나 조직이 만드는 것은 사용자 스킬이다. 고객센터가 드는 예는 브랜드 스타일을 문서와 발표 자료에 입히기, 회사 메일 양식대로 안내문 쓰기, 회사 형식으로 회의록 정리하기, 내 일하는 방식에 맞게 클로드를 맞추기 같은 것들이다. Team · Enterprise 플랜에서는 조직 소유자가 스킬을 전 직원에게 한꺼번에 배포할 수 있고, Notion · Figma · Atlassian 같은 협력사가 만든 스킬도 디렉터리에 올라 있다.
시리즈의 클로드 공식 무료 강좌 Claude 101 — 무엇을 배우고 누구에게 맞나에서 강좌를 훑어본 뒤 가장 쓸모 있었던 단원으로 꼽은 것이 «Working with skills»였다. 이번 글은 그 단원에서 맛본 기능을 고객센터 문서 기준으로 처음부터 끝까지 따라가는 셈이다.
프로젝트 · 지침 · 커넥터와 무엇이 다른가
클로드에는 «미리 알려 두는» 기능이 이미 여럿 있어서 스킬과 헷갈리기 쉽다. 고객센터는 세 가지와 나란히 놓고 차이를 적어 두었다.
- 프로젝트와 비교 — 프로젝트는 그 안에서 대화를 시작할 때마다 늘 불러오는 고정된 배경 지식이다. 스킬은 필요할 때만 켜지는 절차이고 클로드 어디에서든 쓰인다. Claude Academy 튜토리얼은 프로젝트에 올린 자료는 그 프로젝트 안에만 있지만, 스킬은 한 번 만들면 일반 대화 · 프로젝트 안 대화 어디서든 쓸 수 있다고 덧붙인다. 프로젝트 자체는 클로드 프로젝트 기능 — 자료를 모아 두고 계속 쓰는 법에서 다뤘다.
- 사용자 지침과 비교 — 사용자 지침(개인 설정의 지침)은 모든 대화에 넓게 적용된다. 스킬은 특정 일에만 쓰이고 관련 있을 때만 불려 오므로 전문적인 작업 절차에 더 맞는다. 지침에는 «짧게 답해 줘»처럼 모든 일에 통하는 선호를, 스킬에는 «재무 모델을 만들 때는 이 검증 틀을 써»처럼 특정 일에만 쓰는 규칙을 둔다는 것이 튜토리얼의 구분이다. 지침은 클로드 스타일과 개인 설정 — 지침으로 내 말투에 맞추기에 정리했다.
- MCP(커넥터)와 비교 — MCP는 클로드를 외부 서비스와 데이터에 잇는 통로이고, 스킬은 그 일을 «어떻게» 하는지에 대한 절차 지식이다. 둘은 함께 쓸 수 있다.
스킬이 필요할 때만 불려 온다는 말은 구조로 보면 더 분명하다. Claude 개발 문서는 스킬이 세 단계로 나뉘어 불려 온다고 설명한다. 1단계는 스킬의 이름과 설명(메타데이터)으로 늘 불러 두며 스킬 하나에 약 100 토큰이다. 2단계는 SKILL.md 본문으로, 요청이 설명과 맞을 때만 읽고 분량은 5k 토큰 미만이다. 3단계는 함께 묶은 참고 파일과 스크립트로, 실제로 읽거나 돌릴 때까지는 자리를 차지하지 않는다. 그래서 스킬을 여러 개 켜 두어도 부담이 작고, 클로드가 어떤 스킬을 고를지는 거의 전적으로 1단계의 «설명» 한 줄에 달려 있다. 이 점이 뒤에서 볼 문제 해결의 핵심이다.
정리하면 «자료가 쌓이는 일»은 프로젝트, «모든 대화에 통하는 말투»는 지침, «정해진 방식이 있는 반복 작업»은 스킬이다. 튜토리얼도 꾸준히 쌓이는 맥락과 표준 절차가 둘 다 필요한 일이라면 프로젝트와 스킬을 함께 쓰라고 권한다.
클로드 스킬 켜고 첫 스킬 만들기 — 대화로 또는 직접
스킬을 쓰려면 먼저 코드 실행이 켜져 있어야 한다. 개인 플랜(Free · Pro · Max)은 다음 순서다.
- «설정 › 기능»으로 간다. 영문 화면은 Settings › Capabilities다.
- «코드 실행 및 파일 생성»을 켠다. 새 설정 화면에서는 «파일 생성 및 편집»이라는 이름으로 보인다.
- «사용자 정의 › 스킬»로 간다. 영문 화면은 Customize › Skills다.
- 쓰고 싶은 스킬을 하나씩 켜거나 끈다.
Team 플랜은 조직 차원에서 기본으로 켜져 있고, Enterprise 플랜은 소유자가 «조직 설정 › 플러그인 및 스킬»의 «정책» 탭에서 코드 실행과 스킬을 둘 다 켜 두어야 구성원이 쓸 수 있다. 회사 계정인데 스킬 메뉴가 안 보인다면 이 설정부터 관리자에게 확인한다.
켰으면 Anthropic이 만든 스킬부터 써 본다. 고객센터는 사용자 스킬을 만들기 전에 이 기본 스킬로 작동 방식을 익히라고 권한다. 엑셀 스프레드시트 만들기와 고치기, 워드 문서 만들기, 파워포인트 발표 자료 만들기, PDF 만들기와 처리가 여기에 들고, 따로 부를 필요 없이 «3분기 실적 발표 자료를 파워포인트로 만들어 줘»라고만 해도 클로드가 파워포인트 스킬을 쓴다. 표 파일 다루기는 시리즈의 클로드로 엑셀·CSV 분석하기 — 표 정리부터 그래프·결과 파일까지에서 자세히 봤다.
첫 스킬을 만드는 두 길
사용자 스킬을 만드는 길은 크게 둘이다. Claude Academy 튜토리얼은 파일을 직접 써서 구조를 완전히 손에 쥐는 길과, 클로드와 대화하며 과정을 설명하면 클로드가 형식과 구조를 맡는 길을 나눠 설명한다.
대화로 만들기. 코딩을 몰라도 되는 쪽이다. 순서는 네 단계다.
- 새 대화에서 «주간 업무 보고용 스킬을 만들고 싶어»처럼 말을 꺼낸다. 평소 쓰는 양식, 잘됐던 결과물, 따르는 규칙 문서가 있으면 함께 올린다.
- 클로드가 묻는 질문에 답한다. «언제 이 스킬을 쓰나», «이 일에서 좋은 결과란 무엇인가» 같은 질문이 오고, 능력은 있지만 내 일을 처음 보는 사람이 따라 할 수 있을 만큼 자세히 답하면 된다.
- 클로드가 skill-creator 스킬을 읽어 SKILL.md 파일을 만들고, 올린 자료를 정리하고, 필요하면 스크립트까지 만들어 스킬 파일 하나로 묶는다.
- 만들어진 스킬 파일을 저장해 켜고, 그 스킬이 맡을 일을 시켜 보며 결과가 다르면 고쳐 달라고 한다.
튜토리얼은 설명할 때 세 가지를 꼭 넣으라고 한다. 형식(«성과 · 막힌 점 · 우선순위 세 칸, 칸마다 세 줄 이내»), 어조(누가 읽고 어떻게 읽혀야 하나), 그리고 마음에 들었던 실제 결과물 한 개다. 좋은 예시 하나가 품질 기준을 어떤 설명보다 잘 전한다는 것이 튜토리얼의 설명이다. 이 세 가지는 시리즈의 클로드에게 잘 묻는 법 — 공식 가이드의 기본 원칙에서 본 요청 쓰는 원칙과 같은 뿌리다.
직접 쓰기. 파일 구조를 알면 더 세밀하게 고칠 수 있다. 스킬은 최소한 SKILL.md 파일 하나가 든 폴더이고(고객센터 표기는 skill.md), 이 파일은 맨 위에 name과 description을 담은 머리말(YAML)로 시작해야 한다. 머리말의 name은 최대 64자, description은 무엇을 하는 스킬이고 언제 써야 하는지를 적는 칸으로 최대 200자다. 클로드는 이 description을 보고 스킬을 부를지 정하므로 가장 공을 들일 칸이다. 앞의 주간 보고 예를 직접 쓰면 이런 모양이 된다.
---
name: weekly-report
description: 주간 업무 보고를 성과·막힌 점·다음 주 할 일 세 칸으로 정리한다. 사용자가 주간 보고, 주간 정리, 팀장 보고를 요청할 때 쓴다.
---
# 주간 업무 보고
## 형식
- 세 칸: 성과 / 막힌 점 / 다음 주 할 일
- 칸마다 세 줄 이내, 한 줄은 한 문장
## 어조
- 팀장이 훑어보기 좋게, 사실 위주로 짧게
## 좋은 예
(마음에 들었던 지난 보고 한 편을 붙여 넣는다)이름은 소문자 · 숫자 · 하이픈만 쓰고 «claude» «anthropic» 같은 예약어를 넣지 않는 것이 개발 문서의 규칙이라 처음부터 그 모양으로 지어 두면 어느 쪽 기준에도 맞는다. 설명은 «나는 ~을 도와줄 수 있다»가 아니라 «~을 정리한다»처럼 3인칭으로, 무엇을 하는지와 언제 쓰는지를 함께 적는다. 폴더 이름은 스킬 이름과 같게 맞추고, 폴더째 ZIP으로 묶는다. 이때 ZIP을 열면 파일이 바로 나오는 게 아니라 스킬 폴더가 맨 위에 있어야 한다. 그다음 «사용자 정의 › 스킬»에서 «+» › «스킬 만들기» › «스킬 업로드»로 ZIP을 올리면 목록에 나타나고 켜고 끌 수 있다.
인용 — Claude Academy «Teach Claude your way of working using skills»«Creating a skill is an act of description.» — 스킬을 만드는 일은 곧 설명하는 일이다.
튜토리얼은 스킬을 다 만들 즈음이면 그 일에 필요한 형식, 내 목소리에 맞는 어조, 좋은 결과물의 예를 말로 짚을 수 있게 되고, 그 셋을 한 번에 클로드에게 넘기게 된다고 이어 적었다. 스킬의 품질은 결국 설명의 품질이라는 뜻이다.
클로드 스킬이 안 불릴 때 — 설명 문장부터 고친다
스킬을 만들었는데 클로드가 쓰지 않거나, 메뉴 자체가 안 보이는 경우가 있다. 고객센터 문제 해결 절을 증상별로 옮기면 다음과 같다.
스킬 메뉴가 안 보인다. 개인 플랜은 «설정 › 기능»에서, Team · Enterprise는 «조직 설정 › 플러그인 및 스킬»의 «정책» 탭에서 코드 실행이 켜져 있는지 확인한다. 스킬은 코드 실행 환경이 있어야 돌아간다.
스킬이 회색으로 보인다. 조직 차원이나 개인 설정에서 코드 실행이 꺼져 있을 수 있다. 회사 계정이면 조직 소유자에게, 개인 계정이면 «설정 › 기능»을 본다.
클로드가 스킬을 쓰지 않는다. 스킬이 켜져 있는지, 설명이 언제 써야 하는지를 분명히 말하는지, 본문 지시가 잘 짜여 있는지 확인하고, 요청할 때 «내 브랜드 규칙 스킬로 발표 자료를 만들어 줘»처럼 스킬을 직접 짚어 본다.
올리기가 실패한다. 흔한 원인은 ZIP 크기 제한 초과, 폴더 이름과 스킬 이름 불일치, skill.md 파일 누락, 이름이나 설명에 쓸 수 없는 글자다.
만들기나 올리기 버튼이 없다. Team · Enterprise 플랜에서는 조직 소유자가 사용자 스킬 만들기를 꺼 둘 수 있다. 그래도 소유자가 배포한 스킬은 켜서 쓸 수 있다.
설명 한 줄 다듬기와 시험하는 법
증상 가운데 가장 흔한 «클로드가 스킬을 쓰지 않는다»는 대개 설명 문장 문제다. 앞에서 본 대로 클로드는 늘 불러 둔 이름과 설명만 보고 스킬을 고르기 때문이다. 개발 문서는 «문서를 도와줌»이나 «데이터를 처리함» 같은 막연한 설명을 피하고, 하는 일과 함께 «PDF 파일을 다룰 때나 사용자가 PDF · 양식 · 문서 추출을 말할 때 쓴다»처럼 언제 쓰는지를 구체적인 낱말로 적으라고 예를 든다. 스킬이 100개가 넘어도 클로드가 그 가운데서 고를 수 있을 만큼 구체적이어야 한다는 것이다. 한국어로 일한다면 실제로 요청할 때 쓰는 말(«주간 보고», «주간 정리»)을 설명에 넣어 두면 맞추기 쉽다.
시험은 올리기 전과 후로 나눈다. 올리기 전에는 설명이 언제 써야 하는지를 정확히 담았는지, 본문에서 가리킨 파일이 제자리에 있는지 확인한다. 올린 뒤에는 스킬을 켜고, 그 스킬이 불려야 할 요청을 여러 가지로 바꿔 시켜 보고, 클로드의 생각 과정에서 스킬을 읽는지 확인한다. Claude Academy 튜토리얼은 생각 과정에 «Reading [스킬 이름]»이 보이는지 보고, 없으면 스킬 이름이나 설명을 고치거나 요청에서 스킬 이름을 직접 부르라고 안내한다. 결과물을 스킬에 넣어 둔 좋은 예와 나란히 놓고 짜임과 말투가 같은지 보는 것이 두 번째 확인이다. 여전히 손으로 고치게 되는 곳이 있다면 그 부분이 스킬 본문에서 다듬을 줄이다.
Claude Code에서 쓴다면 확인 수단이 몇 가지 더 있다. /스킬이름으로 직접 부를 수 있고, 반대로 스킬이 원하지 않을 때 자꾸 불린다면 설명을 더 좁히거나 머리말에 disable-model-invocation: true를 넣어 직접 부를 때만 돌게 할 수 있다. Claude Code 문서는 스킬 목록에 들어가는 설명이 1,536자에서 잘리니 가장 중요한 쓰임을 앞에 두라고도 적었다. Claude Code 설치는 클로드 코드 설치·요금제·첫 사용 (2026) — Windows에서 시작하기에서 다뤘다.
표의 위쪽 두 줄은 설정 문제, 가운데 줄은 설명 문장 문제, 아래쪽은 파일과 조직 정책 문제다. 어느 갈래인지 먼저 가르면 확인할 곳이 크게 준다.
자주 묻는 것
무료 플랜에서도 클로드 스킬을 쓸 수 있나요?
쓸 수 있습니다. 고객센터 기준 스킬은 Free · Pro · Max · Team · Enterprise 모든 플랜에서 쓸 수 있고, 개인 플랜은 «설정 › 기능»에서 코드 실행 및 파일 생성을 켠 뒤 «사용자 정의 › 스킬»에서 켜고 올립니다.
코딩을 몰라도 스킬을 만들 수 있나요?
만들 수 있습니다. 새 대화에서 만들고 싶은 스킬을 설명하고 클로드의 질문에 답하면 클로드가 SKILL.md를 만들어 스킬 파일로 묶어 줍니다. 간단한 스킬은 마크다운으로 지시만 적으면 되고, 스크립트는 고급 기능을 원할 때 붙입니다.
프로젝트에 지시를 넣어 두는 것과 무엇이 다른가요?
프로젝트의 자료와 지시는 그 프로젝트 안 대화에서만 늘 불러오고, 스킬은 관련 있는 요청일 때만 불려 와 일반 대화와 프로젝트 어디서든 쓰입니다. 쌓이는 맥락은 프로젝트에, 되풀이하는 절차는 스킬에 두고 함께 쓰는 것이 공식 튜토리얼의 권장입니다.
동료가 보내 준 스킬을 그냥 켜도 되나요?
켜기 전에 안에 든 파일부터 읽어 보는 것이 고객센터의 권고입니다. 동료가 공유한 것도 덜 믿을 만한 출처로 보고, 코드 의존성 · 묶인 스크립트 · 외부 주소 접속 지시를 확인합니다.
클로드 앱에서 만든 스킬을 클로드 코드에서도 쓸 수 있나요?
같은 Claude 계정으로 로그인한 Claude Code v2.1.273 이상이면 클로드 설정에서 켠 스킬이 한 방향으로 동기화되어 /skills의 «claude.ai sync» 아래에 보입니다. API 키로 로그인한 Claude Code에서는 동기화되지 않습니다.
정리 — 두 번 설명한 일은 스킬로
클로드 스킬은 지시 · 스크립트 · 자료를 담은 폴더로, 관련 있는 요청일 때만 불려 와 어느 대화에서든 같은 방식으로 일하게 하는 기능이고, 코드 실행만 켜면 Free 플랜부터 쓸 수 있다. 프로젝트가 쌓이는 배경 지식, 지침이 모든 대화의 선호라면, 스킬은 특정 일의 절차다. 만드는 길은 클로드와 대화하며 설명하는 쪽과 SKILL.md를 직접 써서 ZIP으로 올리는 쪽 두 가지이고, 어느 쪽이든 형식 · 어조 · 좋은 예 한 개가 품질을 정한다. 클로드는 이름과 설명만 보고 스킬을 고르므로, 안 불리면 설명에 «무엇을 하고 언제 쓰는지»를 평소 요청할 때 쓰는 말로 적어 다시 시험한다. 남이 만든 스킬은 소프트웨어처럼 다루어 켜기 전에 파일을 읽는다. 메뉴 이름과 기능은 자주 바뀌므로 이 글은 2026년 10월 28일 기준으로 읽고, 쓰기 전에 고객센터 문서를 한 번 더 확인한다. 같은 설명을 두 번 이상 붙여 넣은 일이 있다면, 그것이 첫 스킬 후보다.
참고 자료
- Claude Help Center. What are skills? — 스킬 정의 · Free · Pro · Max · Team · Enterprise · 코드 실행 필요 · Anthropic 스킬 · 사용자 스킬 예 · 조직 배포 · 파트너 스킬 · 오픈 표준 agentskills.io · 프로젝트 · MCP · 사용자 지침과 차이(2026-10-28 확인). support.claude.com
- Claude Help Center. Use skills in Claude — Settings › Capabilities › Code execution and file creation · Customize › Skills · Anthropic 스킬 4종 · ZIP 올리기 · 공유와 조직 게시 · Microsoft 365 추가 기능 · Claude Code v2.1.273 이상 동기화 · 약 10분마다 확인 · 보안 위험 · 문제 해결 · 모범 사례(2026-10-28 확인). support.claude.com
- Claude Help Center. How to create custom skills — 스킬 녹화(맥 Cowork · Pro · Max · Team · 약 10분) · skill.md 머리말 name 64자 · description 200자 · dependencies · 자료와 스크립트 · ZIP 구조 · 올리기 전후 시험 · 보안(2026-10-28 확인). support.claude.com
- Claude Academy. Teach Claude your way of working using skills — 스킬과 프로젝트 · 사용자 지침 · 일반 프롬프트 비교 · 형식 · 어조 · 좋은 예시 세 가지 · 주간 업무 보고 예 · «Reading [스킬 이름]» 확인(2026-10-28 확인). academy.claude.com
- Claude Academy. How to create a skill with Claude through conversation — 대화로 스킬 만들기 4단계 · skill-creator 스킬 · 넣을 수 있는 자료와 스크립트(2026-10-28 확인). academy.claude.com
- Claude Docs. Agent Skills overview — 3단계 불러오기(메타데이터 약 100 토큰 · 본문 5k 토큰 미만 · 자료는 읽을 때만) · name과 description 규칙 · 보안 · API는 네트워크 없음 · 화면마다 따로 올림(2026-10-28 확인). platform.claude.com
- Claude Docs. Skill authoring best practices — 짧게 쓰기 · 설명은 3인칭 · 무엇과 언제를 함께 · 본문 500줄 이내 · 이름 짓기(2026-10-28 확인). platform.claude.com
- Claude Code Docs. Extend Claude with skills — ~/.claude/skills · .claude/skills · /스킬이름 · disable-model-invocation · 설명 1,536자에서 잘림 · 안 불릴 때와 너무 자주 불릴 때 · /skills의 claude.ai sync(2026-10-28 확인). code.claude.com
- Claude 고객센터. Claude에서 스킬 사용하기 — 한국어판 «설정 › 기능» «코드 실행 및 파일 생성» «파일 생성 및 편집» «사용자 정의 › 스킬» «스킬 만들기» «스킬 업로드» 화면 이름(2026-10-28 확인). support.claude.com