CLAUDE · SKILLS · WORKFLOW

클로드 스킬 — 반복하는 일을 규칙으로 저장하고 꺼내 쓰는 법

junetapa 2026. 10. 28 업데이트 약 17분

클로드(Claude)에게 주간 업무 보고를 부탁할 때마다 «성과 · 막힌 점 · 다음 주 할 일 세 칸으로, 칸마다 세 줄 이내로, 팀장이 훑어보기 좋게»라고 같은 설명을 다시 붙여 넣고 있다면, 그 설명은 저장해 둘 때가 된 것이다. 클로드의 «스킬(Skills)»은 이렇게 되풀이하는 일하는 방식을 한 번 정리해 두면, 비슷한 일을 시킬 때 클로드가 알아서 꺼내 쓰게 하는 기능이다. Claude 고객센터는 스킬을 클로드가 특정 일을 매번 같은 방식으로 해내도록 가르치는 지시 · 스크립트 · 자료의 폴더라고 설명한다. 이 글은 2026년 10월 28일에 Claude 고객센터의 스킬 문서 세 편과 한국어판, Claude Academy 튜토리얼 두 편, Claude 개발 문서와 Claude Code 문서를 직접 열어 대조한 내용이다. 스킬이 무엇인지, 켜고 첫 스킬을 만드는 법, 스킬이 불리지 않을 때 고칠 곳, 공유와 보안에서 알아 둘 점을 차례로 정리했다.

클로드 제대로 쓰기

이 글은 «클로드 제대로 쓰기» 시리즈의 16번째 글이다. 가입 · 앱 · 요금제 고르기는 시작 글 클로드 처음 쓰기 — 웹·데스크톱·모바일 앱과 요금제 고르기에, 브라우저 일을 맡기는 법은 바로 앞 글 클로드 in 크롬 사용법 — 설치·권한 모드·맡기면 안 되는 일에 정리했다. 앞 글이 클로드에게 «손»을 하나 더 붙이는 이야기였다면, 이번 글은 클로드에게 «내 일하는 방식»을 기억시키는 이야기다.

클로드 스킬이란 — 매번 하던 설명을 폴더 하나에

고객센터의 정의부터 옮기면, 스킬은 클로드가 전문적인 일을 더 잘하도록 필요할 때 불러오는 지시 · 스크립트 · 자료의 폴더다. 회사 브랜드 규칙에 맞춘 문서 만들기, 조직의 방식대로 데이터 분석하기, 개인적인 일 처리하기처럼 «정해진 방식이 있는 일»을 매번 같은 품질로 해내게 하는 것이 목적이다.

쓸 수 있는 사람의 폭은 넓다. 스킬은 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단계의 «설명» 한 줄에 달려 있다. 이 점이 뒤에서 볼 문제 해결의 핵심이다.

클로드 스킬과 다른 기능 비교 도해 — 스킬: 필요할 때만 불려 옴 · 어느 대화에서든 · 특정 일의 절차. 프로젝트: 그 안에서 늘 불러옴 · 프로젝트 안에서만 · 쌓이는 배경 지식. 사용자 지침: 모든 대화에 적용 · 모든 일에 통하는 선호. MCP 커넥터: 외부 서비스와 데이터를 잇는 통로 · 스킬과 함께 씀
스킬 · 프로젝트 · 사용자 지침 · 커넥터는 맡는 일이 다르다 — 2026년 10월 28일 Claude 고객센터 · Claude Academy 기준.

정리하면 «자료가 쌓이는 일»은 프로젝트, «모든 대화에 통하는 말투»는 지침, «정해진 방식이 있는 반복 작업»은 스킬이다. 튜토리얼도 꾸준히 쌓이는 맥락과 표준 절차가 둘 다 필요한 일이라면 프로젝트와 스킬을 함께 쓰라고 권한다.

클로드 스킬 켜고 첫 스킬 만들기 — 대화로 또는 직접

스킬을 쓰려면 먼저 코드 실행이 켜져 있어야 한다. 개인 플랜(Free · Pro · Max)은 다음 순서다.

  1. «설정 › 기능»으로 간다. 영문 화면은 Settings › Capabilities다.
  2. «코드 실행 및 파일 생성»을 켠다. 새 설정 화면에서는 «파일 생성 및 편집»이라는 이름으로 보인다.
  3. «사용자 정의 › 스킬»로 간다. 영문 화면은 Customize › Skills다.
  4. 쓰고 싶은 스킬을 하나씩 켜거나 끈다.

Team 플랜은 조직 차원에서 기본으로 켜져 있고, Enterprise 플랜은 소유자가 «조직 설정 › 플러그인 및 스킬»의 «정책» 탭에서 코드 실행과 스킬을 둘 다 켜 두어야 구성원이 쓸 수 있다. 회사 계정인데 스킬 메뉴가 안 보인다면 이 설정부터 관리자에게 확인한다.

켰으면 Anthropic이 만든 스킬부터 써 본다. 고객센터는 사용자 스킬을 만들기 전에 이 기본 스킬로 작동 방식을 익히라고 권한다. 엑셀 스프레드시트 만들기와 고치기, 워드 문서 만들기, 파워포인트 발표 자료 만들기, PDF 만들기와 처리가 여기에 들고, 따로 부를 필요 없이 «3분기 실적 발표 자료를 파워포인트로 만들어 줘»라고만 해도 클로드가 파워포인트 스킬을 쓴다. 표 파일 다루기는 시리즈의 클로드로 엑셀·CSV 분석하기 — 표 정리부터 그래프·결과 파일까지에서 자세히 봤다.

작은 로봇이 빈 종이 한 장을 앞에 두고, 옆에 놓인 둥근 말풍선 모양의 판에서 흘러나온 빛줄기가 종이 위에서 가지런한 칸과 줄로 정리되는 모습을 지켜보는 그림 — 말로 설명한 일하는 방식이 정리된 스킬 파일로 바뀌는 개념
말로 설명하면 정리된 파일이 된다 — 대화로 스킬 만들기.

첫 스킬을 만드는 두 길

사용자 스킬을 만드는 길은 크게 둘이다. Claude Academy 튜토리얼은 파일을 직접 써서 구조를 완전히 손에 쥐는 길과, 클로드와 대화하며 과정을 설명하면 클로드가 형식과 구조를 맡는 길을 나눠 설명한다.

대화로 만들기. 코딩을 몰라도 되는 쪽이다. 순서는 네 단계다.

  1. 새 대화에서 «주간 업무 보고용 스킬을 만들고 싶어»처럼 말을 꺼낸다. 평소 쓰는 양식, 잘됐던 결과물, 따르는 규칙 문서가 있으면 함께 올린다.
  2. 클로드가 묻는 질문에 답한다. «언제 이 스킬을 쓰나», «이 일에서 좋은 결과란 무엇인가» 같은 질문이 오고, 능력은 있지만 내 일을 처음 보는 사람이 따라 할 수 있을 만큼 자세히 답하면 된다.
  3. 클로드가 skill-creator 스킬을 읽어 SKILL.md 파일을 만들고, 올린 자료를 정리하고, 필요하면 스크립트까지 만들어 스킬 파일 하나로 묶는다.
  4. 만들어진 스킬 파일을 저장해 켜고, 그 스킬이 맡을 일을 시켜 보며 결과가 다르면 고쳐 달라고 한다.

튜토리얼은 설명할 때 세 가지를 꼭 넣으라고 한다. 형식(«성과 · 막힌 점 · 우선순위 세 칸, 칸마다 세 줄 이내»), 어조(누가 읽고 어떻게 읽혀야 하나), 그리고 마음에 들었던 실제 결과물 한 개다. 좋은 예시 하나가 품질 기준을 어떤 설명보다 잘 전한다는 것이 튜토리얼의 설명이다. 이 세 가지는 시리즈의 클로드에게 잘 묻는 법 — 공식 가이드의 기본 원칙에서 본 요청 쓰는 원칙과 같은 뿌리다.

직접 쓰기. 파일 구조를 알면 더 세밀하게 고칠 수 있다. 스킬은 최소한 SKILL.md 파일 하나가 든 폴더이고(고객센터 표기는 skill.md), 이 파일은 맨 위에 name과 description을 담은 머리말(YAML)로 시작해야 한다. 머리말의 name은 최대 64자, description은 무엇을 하는 스킬이고 언제 써야 하는지를 적는 칸으로 최대 200자다. 클로드는 이 description을 보고 스킬을 부를지 정하므로 가장 공을 들일 칸이다. 앞의 주간 보고 예를 직접 쓰면 이런 모양이 된다.

markdown
---
name: weekly-report
description: 주간 업무 보고를 성과·막힌 점·다음 주 할 일 세 칸으로 정리한다. 사용자가 주간 보고, 주간 정리, 팀장 보고를 요청할 때 쓴다.
---
# 주간 업무 보고

## 형식
- 세 칸: 성과 / 막힌 점 / 다음 주 할 일
- 칸마다 세 줄 이내, 한 줄은 한 문장

## 어조
- 팀장이 훑어보기 좋게, 사실 위주로 짧게

## 좋은 예
(마음에 들었던 지난 보고 한 편을 붙여 넣는다)

이름은 소문자 · 숫자 · 하이픈만 쓰고 «claude» «anthropic» 같은 예약어를 넣지 않는 것이 개발 문서의 규칙이라 처음부터 그 모양으로 지어 두면 어느 쪽 기준에도 맞는다. 설명은 «나는 ~을 도와줄 수 있다»가 아니라 «~을 정리한다»처럼 3인칭으로, 무엇을 하는지와 언제 쓰는지를 함께 적는다. 폴더 이름은 스킬 이름과 같게 맞추고, 폴더째 ZIP으로 묶는다. 이때 ZIP을 열면 파일이 바로 나오는 게 아니라 스킬 폴더가 맨 위에 있어야 한다. 그다음 «사용자 정의 › 스킬»에서 «+» › «스킬 만들기» › «스킬 업로드»로 ZIP을 올리면 목록에 나타나고 켜고 끌 수 있다.

클로드 스킬 만드는 두 길 도해 — 대화로 만들기: 새 대화에서 만들고 싶다고 말하기 · 양식과 좋은 예 올리기 · 질문에 답하기 · 클로드가 SKILL.md를 만들어 묶음 · 저장하고 켜서 시험. 직접 쓰기: 폴더 안에 SKILL.md · 머리말 name 64자 · description 200자 · 폴더째 ZIP · 사용자 정의 › 스킬 › + › 스킬 만들기 › 스킬 업로드. 공통: 형식 · 어조 · 좋은 예 한 개
대화로 만들기와 SKILL.md 직접 쓰기 — 2026년 10월 28일 Claude 고객센터 · Claude Academy 기준.
인용 — 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에서 시작하기에서 다뤘다.

클로드 스킬 문제 해결 도해 — 스킬 메뉴가 안 보임: 설정 › 기능에서 코드 실행 켜기. 회색으로 보임: 조직 또는 개인 코드 실행 꺼짐 확인. 클로드가 안 씀: 켜짐 확인 · 설명에 언제 쓰는지 · 요청에 스킬 이름. 올리기 실패: ZIP 크기 · 폴더 이름과 스킬 이름 · skill.md 누락 · 쓸 수 없는 글자. 만들기 버튼 없음: 조직이 사용자 스킬을 꺼 둠. 너무 자주 불림(Claude Code): 설명 좁히기 · disable-model-invocation
증상별로 먼저 확인할 곳 — 2026년 10월 28일 Claude 고객센터 · Claude Code 문서 기준.

표의 위쪽 두 줄은 설정 문제, 가운데 줄은 설명 문장 문제, 아래쪽은 파일과 조직 정책 문제다. 어느 갈래인지 먼저 가르면 확인할 곳이 크게 준다.

스킬 공유와 보안 — 남이 만든 스킬을 켜기 전에

스킬은 혼자 쓰다가 동료와 나누고 싶어지는 기능이다. 업로드한 사용자 스킬은 공유하기 전까지 동료에게 보이지 않고, 관리자도 이름과 공유 상태만 볼 뿐 파일은 보지 못한다. Team · Enterprise 플랜에서는 «사용자 정의 › 스킬»에서 직접 만든 스킬 옆 점 세 개 메뉴 › «공유»로 특정 동료에게 나눌 수 있고, Enterprise는 미리 만든 그룹에도 나눌 수 있다. 공유받은 스킬은 보기 전용이라 켜서 쓸 수는 있지만 내용은 못 고치고, 원래 만든 사람이 고치면 다음에 쓸 때 새 판으로 바뀐다. 조직 전체에 내놓고 싶으면 «조직에 게시»로 조직 라이브러리에 올리며, 조직이 검토를 요구하면 소유자의 승인을 거친다. 개인 플랜에서는 각자 자기 계정에 스킬을 올린다.

클로드 앱 밖으로도 이어진다. 클로드 설정에서 켠 스킬은 Claude for Excel · PowerPoint · Word · Outlook 추가 기능에서도 쓸 수 있다. 같은 Claude 계정으로 로그인한 Claude Code에도 불려 오는데, Claude Code v2.1.273 이상이 필요하고, 세션을 시작할 때 동기화한 뒤 약 10분마다 바뀐 것을 확인한다. 이 동기화는 계정에서 읽기만 하는 한 방향이고, Claude Code를 API 키로 쓰면 동기화되지 않는다. Claude Code에서 /skills를 치면 «claude.ai sync» 아래에 동기화된 스킬이 보인다. 반대로 내 PC의 Claude Code 개인 스킬 폴더(~/.claude/skills/)나 프로젝트 폴더(.claude/skills/)에 만든 스킬은 그 PC 파일로 남는다. 개발 문서도 claude.ai에 올린 스킬과 API에 올린 스킬은 서로 따로 올려야 한다고 적었다.

작은 로봇이 문 앞에서 낯선 상자 하나를 받아 들고, 바로 열어 쓰지 않고 탁자 위에서 뚜껑을 살짝 열어 안을 들여다보며 확인하는 그림 — 남이 만든 스킬을 켜기 전에 안에 든 파일부터 살펴보는 개념
받은 상자는 열어 보고 쓴다 — 남이 만든 스킬을 켜기 전에.

보안 점검과 알아 둘 제한

스킬은 지시뿐 아니라 실행되는 코드도 담을 수 있어서 보안을 따로 챙겨야 한다. 고객센터는 스킬 사용의 가장 큰 위험으로 클로드를 속여 의도하지 않은 행동을 하게 만드는 프롬프트 주입과, 악성 패키지 코드나 주입된 지시로 인한 데이터 유출을 꼽는다. 그래서 믿을 수 있는 출처의 스킬만 설치하고, 동료가 공유한 것을 포함해 덜 믿을 만한 출처의 스킬은 켜기 전에 안에 든 파일을 읽어 보라고 권한다. 특히 코드 의존성, 함께 묶인 이미지나 스크립트, 그리고 믿을 수 없는 외부 주소에 접속하라는 지시가 있는지 살핀다. 개발 문서는 스킬 설치를 소프트웨어 설치처럼 다루라고 하고, 외부 주소에서 내용을 가져오는 스킬은 가져온 내용에 악성 지시가 섞일 수 있어 특히 위험하다고 적었다. 직접 만드는 스킬에는 API 키나 비밀번호를 적어 넣지 않는다. Enterprise 플랜은 조직이 스킬 검사를 켜 두면 올리거나 고친 외부 스킬을 실행 전에 악성 내용이 있는지 검사하고, 대부분 1~2분 안에 끝난다.

맥을 쓰는 사람에게는 손으로 쓰지 않고 만드는 길도 하나 더 있다. Cowork에서 화면을 녹화하며 평소처럼 일하면 클로드가 그것을 보고 스킬을 제안하는 «스킬 녹화»다. 다만 Claude for Mac의 Cowork에서 Pro · Max · Team 플랜만 쓸 수 있고, 채팅 · Windows · Free · Enterprise 플랜에서는 쓸 수 없으며, 녹화는 약 10분까지다. 녹화하는 동안 화면과 목소리가 모두 담기므로 비밀번호나 민감한 정보는 띄우지 않는다.

크기 기준도 알아 둔다. 개발 문서는 SKILL.md 본문을 500줄 이내로 유지하고, 넘을 것 같으면 참고 파일로 나누라고 권한다. 클로드가 이미 아는 일반 지식을 길게 설명하기보다, 클로드가 모르는 내 규칙만 짧게 적는 것이 좋다는 것이 같은 문서의 첫 원칙이다. 고객센터의 모범 사례도 하나의 거대한 스킬보다 목적별로 나눈 여러 스킬이 서로 더 잘 맞물린다고 적었다. 스킬끼리 서로를 직접 부를 수는 없지만, 클로드가 필요한 스킬 여럿을 알아서 함께 쓴다.

클로드 스킬 쓰기 전 점검표 도해 — 불러오는 방식: 이름과 설명 약 100 토큰 늘 · 본문 5k 토큰 미만 불릴 때 · 참고 파일 읽을 때만. 어디서 쓰나: claude.ai에서 켠 스킬은 Claude Code v2.1.273 이상에 한 방향 동기화 · API는 따로 올림. 공유: 공유 전엔 나만 · 공유받은 스킬은 보기 전용 · 조직에 게시는 검토. 보안: 믿을 수 있는 출처만 · 켜기 전에 파일 읽기 · 외부 주소 접속 지시 확인 · 비밀번호 넣지 않기
불러오는 방식 · 쓰는 곳 · 공유 · 보안 — 2026년 10월 28일 Claude 고객센터 · Claude 개발 문서 기준.

처음 만드는 스킬은 하나의 일, 하나의 형식만 담은 작은 것으로 시작하기를 권한다. 고객센터도 복잡한 스크립트보다 마크다운 지시로 단순하게 시작해 큰 변화마다 시험하라고 적었다. 주간 보고처럼 이미 두 번 이상 같은 설명을 해 본 일이 첫 후보로 알맞다.

자주 묻는 것

무료 플랜에서도 클로드 스킬을 쓸 수 있나요?

쓸 수 있습니다. 고객센터 기준 스킬은 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일 기준으로 읽고, 쓰기 전에 고객센터 문서를 한 번 더 확인한다. 같은 설명을 두 번 이상 붙여 넣은 일이 있다면, 그것이 첫 스킬 후보다.

클로드 스킬 사용법 대표 그림 — 왼쪽에 «클로드 제대로 쓰기 · 클로드 스킬» 제목과 «Free 플랜도 가능» «코드 실행 켜야 함» 배지가 있고, 오른쪽에 작은 로봇이 얇은 폴더가 꽂힌 선반에서 폴더 하나를 꺼내 펼쳐 보는 장면
클로드 스킬 — 반복하는 일을 규칙으로 저장하고 꺼내 쓰는 법.

참고 자료

  1. Claude Help Center. What are skills? — 스킬 정의 · Free · Pro · Max · Team · Enterprise · 코드 실행 필요 · Anthropic 스킬 · 사용자 스킬 예 · 조직 배포 · 파트너 스킬 · 오픈 표준 agentskills.io · 프로젝트 · MCP · 사용자 지침과 차이(2026-10-28 확인). support.claude.com
  2. 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
  3. 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
  4. Claude Academy. Teach Claude your way of working using skills — 스킬과 프로젝트 · 사용자 지침 · 일반 프롬프트 비교 · 형식 · 어조 · 좋은 예시 세 가지 · 주간 업무 보고 예 · «Reading [스킬 이름]» 확인(2026-10-28 확인). academy.claude.com
  5. Claude Academy. How to create a skill with Claude through conversation — 대화로 스킬 만들기 4단계 · skill-creator 스킬 · 넣을 수 있는 자료와 스크립트(2026-10-28 확인). academy.claude.com
  6. Claude Docs. Agent Skills overview — 3단계 불러오기(메타데이터 약 100 토큰 · 본문 5k 토큰 미만 · 자료는 읽을 때만) · name과 description 규칙 · 보안 · API는 네트워크 없음 · 화면마다 따로 올림(2026-10-28 확인). platform.claude.com
  7. Claude Docs. Skill authoring best practices — 짧게 쓰기 · 설명은 3인칭 · 무엇과 언제를 함께 · 본문 500줄 이내 · 이름 짓기(2026-10-28 확인). platform.claude.com
  8. 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
  9. Claude 고객센터. Claude에서 스킬 사용하기 — 한국어판 «설정 › 기능» «코드 실행 및 파일 생성» «파일 생성 및 편집» «사용자 정의 › 스킬» «스킬 만들기» «스킬 업로드» 화면 이름(2026-10-28 확인). support.claude.com
이 글의 기능 · 메뉴 이름 · 플랜별 내용은 2026년 10월 28일에 Claude 고객센터 문서(What are skills? · Use skills in Claude와 한국어판 · How to create custom skills), Claude Academy 튜토리얼(Teach Claude your way of working using skills · How to create a skill with Claude through conversation), Claude 개발 문서(Agent Skills overview · Skill authoring best practices)와 Claude Code 문서(Extend Claude with skills)를 열어 확인한 내용이다. 메뉴 이름은 계정 · 플랜 · 앱 버전에 따라 다를 수 있다. 기능 비교, 두 길 단계, 증상별 확인 순서, 점검표와 주간 보고 SKILL.md 예시는 공식 문서를 바탕으로 이 글에서 만든 것이고 결과를 보장하지 않는다. 이 글은 Anthropic과 관계없는 개인 블로그의 정리다.
클로드Claude클로드스킬ClaudeSkillsSKILLmd에이전트스킬업무자동화프롬프트AI도구클로드제대로쓰기
junetapa(박준철)
AI 도구를 직접 굴려 보고 남은 기록을 정리한다.
Twitter Facebook URL 복사