이 글을 다 읽고 나면 Claude 앱에서 나만의 Skill(스킬 — Claude가 특정 작업을 더 잘하도록 필요할 때 불러 쓰는 지침 묶음)을 직접 만들어 켜고, 회사(Team·Enterprise) 계정에서 팀 전체에 적용하고, 개발자라면 API로 스킬을 관리하는 방법까지 알 수 있습니다. 실습까지 포함해 약 10~15분이면 충분합니다. Anthropic이 2025년 10월 공식 발표하고 이후 몇 차례 업데이트한 Agent Skills 기능을, 공식 발표 내용만을 근거로 정리했습니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
시작 전 준비물
Skills를 쓰려면 먼저 아래 조건이 갖춰져 있어야 합니다.
- Claude 계정 — 공식 발표에 따르면 Claude 앱의 Skills는 Pro·Max·Team·Enterprise 사용자에게 제공됩니다.
- 웹 또는 데스크톱 Claude 앱 접속 환경.
- Team·Enterprise 계정이라면, 조직 관리자 권한이 있는 사람(또는 관리자의 협조).
- 개발자로서 API·Console에서 스킬을 다루려면 Anthropic Console 계정, 그리고 API 요청에 Code Execution Tool(코드 실행 도구)을 포함하고 Skills 베타 헤더를 지정할 준비.
| 플랜 | 개인이 설정에서 바로 켤 수 있나요 |
|---|---|
| Pro | 예 — 설정에서 바로 켬 |
| Max | 예 — 설정에서 바로 켬 |
| Team | 아니요 — 관리자의 조직 차원 활성화가 먼저 필요 |
| Enterprise | 아니요 — 관리자의 조직 차원 활성화가 먼저 필요 |
용어 빠른 풀이
- Agent Skills(에이전트 스킬) — 지침·스크립트·참고자료를 담은 폴더로, Claude가 필요할 때만 불러 쓰는 전문 지식 묶음.
- SKILL.md — 스킬 폴더 안에 들어가는 설명·지침 파일.
- skill-creator — Claude 앱에서 대화만으로 스킬 폴더와 SKILL.md를 자동 생성해 주는 스킬.
- Code Execution Tool(코드 실행 도구) — API에서 Skills 안의 실행 코드가 안전하게 돌아갈 환경을 제공하는 도구. 현행 공식 문서 기준 이 도구 자체는 정식 제공(GA)이며, Skills 쪽이 베타 헤더 지정을 요구합니다.
- /v1/skills 엔드포인트 — 엔드포인트(요청을 보내는 통신 창구) — 개발자가 API로 커스텀 스킬의 버전을 직접 만들고 관리하는 통로.
- Claude Console(클로드 콘솔) — Anthropic이 제공하는 개발자용 관리 화면으로, 스킬 생성·조회·버전 업그레이드를 할 수 있는 곳.
Skills가 실제로 작동하는 원리는 무엇인가요?
Claude는 작업을 시작할 때 사용 가능한 스킬 목록을 먼저 훑어보고, 지금 하려는 작업과 관련된 스킬이 있을 때만 그 스킬의 지침을 불러옵니다. 공식 발표에 따르면 이 방식에는 네 가지 특징이 있습니다. 첫째, 여러 스킬이 필요하면 Claude가 알아서 조합해 함께 쓰는 조합 가능(composable) 방식입니다. 둘째, 같은 형식이라 Claude 앱·Claude Code·API 어디서든 그대로 쓸 수 있는 이식 가능(portable) 방식입니다. 셋째, 필요한 만큼만 불러오는 효율적(efficient) 방식입니다. 넷째, 토큰을 생성하는 것보다 정해진 코드를 실행하는 편이 더 안정적인 작업을 위해 실행 코드를 담을 수 있는 강력한(powerful) 방식입니다. Claude 앱을 쓰다 보면 Claude의 사고 과정(chain of thought)에 지금 어떤 스킬을 불러 쓰고 있는지 표시되는 것도 볼 수 있습니다.
Claude 앱에서 나만의 스킬은 어떻게 만드나요?
Claude 앱에서는 SKILL.md 파일을 직접 작성할 필요 없이, 'skill-creator'라는 스킬에게 원하는 작업 방식을 설명하기만 하면 폴더 구조와 SKILL.md 파일, 필요한 리소스까지 자동으로 만들어 줍니다.
- 설정(Settings) 화면에서 Skills 기능을 켭니다. 정확한 메뉴 명칭은 앱 버전에 따라 다를 수 있으니 화면에 표시된 대로 'Skills' 항목을 찾아 켭니다. → 성공 신호: 이후 대화에서 Skills 관련 항목이 활성화된 상태로 보입니다.
- 새 대화에서 원하는 작업 방식을 설명합니다. 예를 들어 "매주 보고서 양식에 맞춰 엑셀 파일을 만들어주는 스킬을 만들고 싶어"처럼 skill-creator에게 요청합니다. → 성공 신호: Claude가 스킬의 목적과 쓰임새를 되묻는 질문을 시작합니다.
- 질문에 답하며 워크플로를 설명합니다. skill-creator가 스킬 이름, 어떤 상황에서 쓰일지, 어떤 리소스(양식·템플릿 등)가 필요한지 순서대로 물어봅니다. → 성공 신호: 답변을 마치면 Claude가 폴더 구조와 SKILL.md, 필요한 리소스를 자동으로 만들었다고 알려줍니다.
- 완성된 스킬을 그대로 둡니다. 별도 파일 편집이 필요 없으며, 이후 관련 작업을 요청하면 Claude가 알아서 이 스킬을 불러와 씁니다. → 성공 신호: 비슷한 작업을 다시 요청했을 때 Claude의 사고 과정에 방금 만든 스킬 이름이 나타납니다.
회사(Team·Enterprise) 계정에서는 무엇이 다른가요?
Team·Enterprise 플랜에서는 사용자 개인이 설정에서 Skills를 켜기 전에, 조직 관리자가 먼저 조직 전체 차원에서 Skills 기능 자체를 켜둬야 합니다. 관리자가 아직 활성화하지 않았다면 개별 사용자 화면에는 Skills 항목이 보이지 않거나 꺼진 상태로 남아 있을 수 있습니다.
개발자는 API·Console에서 스킬을 어떻게 다루나요?
Claude Developer Platform(API)에서는 Messages API 요청에 Skills를 추가해 쓰거나, /v1/skills 엔드포인트를 통해 직접 만든 커스텀 스킬의 버전을 만들고 관리할 수 있습니다. 다만 API로 Skills를 실행하려면 요청에 Code Execution Tool을 함께 포함하고 Skills 베타 헤더(skills-2025-10-02)를 지정해야 합니다. 공식 문서에 따르면 이 도구가 스킬 안의 실행 코드가 안전하게 돌아갈 환경을 제공하며, 도구 자체는 현재 정식 제공(GA) 상태입니다. Anthropic이 미리 만들어 둔 스킬을 쓰면 Claude가 수식이 포함된 엑셀 스프레드시트·파워포인트 프레젠테이션·워드 문서·양식을 채울 수 있는 PDF를 읽고 만들 수 있고, 직접 만든 커스텀 스킬은 Claude Console에서 생성·조회·버전 업그레이드까지 할 수 있습니다.
자주 막히는 지점 & 해결
"Team·Enterprise 계정인데 Skills 항목 자체가 안 보여요"
원인은 대개 관리자가 조직 차원에서 아직 Skills를 켜지 않은 경우입니다. 관리자에게 조직 설정에서 Skills를 먼저 활성화해 달라고 요청하세요.
"API로 스킬을 호출했는데 실행되지 않아요"
요청에 code_execution 도구가 빠졌거나 Skills 베타 헤더(skills-2025-10-02)가 지정되지 않았을 가능성이 큽니다. 둘 다 포함해 다시 요청해 보세요.
이미 만든 스킬이 인식되지 않거나 예상과 다르게 동작하는 세부적인 오류는 별도의 스킬 인식 오류 해결 가이드를 참고하는 것이 더 정확합니다.
응용 및 다음 단계
공식 발표(2025년 12월 18일 업데이트 기준)에 따르면 이후 조직 차원의 스킬 관리 기능, 파트너가 만든 스킬을 모아 둔 디렉터리, 그리고 여러 플랫폼에서 호환되도록 Agent Skills를 공개 표준으로 발행하는 업데이트가 추가되었습니다. 실제 활용 사례로는 Box가 저장된 파일을 조직 표준에 맞는 파워포인트·엑셀·워드 문서로 변환하는 데, Canva가 에이전트를 커스터마이징하는 데 Skills를 활용하고 있다고 밝힌 바 있습니다. 다음 단계로는 Anthropic이 만든 스킬(엑셀·파워포인트·워드·PDF)을 먼저 체험해 보고, 이후 자신의 업무에 맞는 커스텀 스킬을 skill-creator로 만들어 보는 것을 권합니다.
자주 묻는 질문
Q. Free 플랜에서도 Skills를 쓸 수 있나요?
공식 발표에 따르면 Claude 앱의 Skills는 Pro·Max·Team·Enterprise 사용자에게 제공된다고 명시되어 있습니다. Free 플랜은 별도로 언급되지 않았으므로, 정확한 이용 가능 여부는 실제 화면에서 확인하는 것이 안전합니다.
Q. 스킬을 만들려면 코드를 짤 줄 알아야 하나요?
아니요. Claude 앱에서는 skill-creator가 원하는 작업 방식을 묻는 대화만으로 폴더 구조와 SKILL.md, 필요한 리소스까지 자동으로 만들어 주므로 파일을 직접 편집할 필요가 없습니다. 다만 개발자가 API·Console에서 커스텀 스킬을 만들 때는 별도 개발 작업이 필요합니다.
Q. 회사 계정인데 저 혼자 Skills를 켜면 되나요?
아니요. Team·Enterprise 플랜은 관리자가 먼저 조직 전체 차원에서 Skills 기능을 켜야 하고, 그다음에야 개별 사용자가 자신의 설정에서 이용할 수 있습니다.
Q. API로 Skills를 쓰려면 무엇을 추가로 켜야 하나요?
요청에 Code Execution Tool을 포함하고 Skills 베타 헤더를 지정해야 합니다. 공식 문서에 따르면 이 도구가 Skills 실행에 필요한 안전한 환경을 제공하며, 도구 자체는 정식 제공(GA)입니다.