클로드 스킬이란? 많이 들어봤는데 어디에 쓰는 걸까

클로드 스킬이라는 말은 이제 관련 글이나 커뮤니티에서 어렵지 않게 볼 수 있다.

누군가는 직접 만든 스킬을 공유하고, 여러 스킬을 묶어서 사용하는 모습도 보인다.

그런데 막상 처음 접하면 무엇을 뜻하는지부터 애매하다.

새로운 기능을 설치하는 건지, 자주 쓰는 프롬프트를 저장해 놓는 건지, CLAUDE.md와는 무엇이 다른지도 바로 구분되지 않는다.

Claude Code에서 프로젝트를 짧게 사용할 때는 이런 구분이 크게 필요하지 않다.

필요한 내용을 프롬프트에 적고 작업을 맡기면 된다. 프로젝트가 길어지면 원본을 수정하지 않는다거나 결과 파일을 따로 저장한다는 식의 공통 기준을 CLAUDE.md에 남겨둘 수 있다.

분류, 요약, 작성처럼 서로 성격이 다른 작업까지 반복하기 시작하면 이야기가 달라진다.

각 작업마다 필요한 설명과 순서까지 프로젝트 지침 하나에 계속 붙이면 내용이 빠르게 커진다.

지금 하는 일에는 필요하지 않은 규칙까지 같은 지침 안에 섞이고, 필요한 절차를 고치려 할 때 다른 작업의 내용까지 함께 확인해야 한다.

클로드 스킬은 이런 작업 방법을 분류, 요약, 작성처럼 필요한 단위로 떼어 관리하는 방식이다.

클로드 스킬을 아주 쉽게 말하면

한 번 처리하고 끝날 일이라면 프롬프트만으로 충분하다.

“이 자료를 세 가지 주제로 나눠줘.”
“긴 문서에서 중요한 내용만 요약해줘.”
“정리한 내용을 보고서 형태로 작성해줘.”

이런 요청은 필요한 순간에 설명하고 결과를 받으면 된다.

같은 종류의 일을 계속하다 보면 매번 비슷한 설명을 다시 적게 된다.

분류할 때는 어떤 기준으로 나눌지 설명하고, 요약할 때는 무엇을 남기고 무엇을 줄일지 알려주고, 작성할 때는 결과 형식과 작업 순서를 다시 지정한다.

처음에는 이런 내용을 CLAUDE.md 하나에 모아둘 수도 있다. 프로젝트가 단순하다면 오히려 편하다.

작업 종류가 늘어날수록 분류에 필요한 규칙, 요약 기준, 작성 방식이 한 파일 안에 섞이기 시작한다. 분류 작업을 하는데 긴 작성 규칙까지 같이 들어 있고, 요약 방식 하나를 바꾸려고 전체 프로젝트 지침을 다시 살펴보는 식이다.

스킬을 사용하면 이 부분을 작업별로 떼어낼 수 있다.

프로젝트 전체에서 늘 지켜야 하는 내용과 특정 일을 할 때만 필요한 작업 방법을 나누는 것이다.

예를 들어 ‘원본 파일은 수정하지 않는다’는 규칙은 분류를 하든 요약을 하든 계속 지켜야 한다. 이런 내용은 프로젝트 전체 기준으로 둔다.

반대로 ‘자료를 어떤 기준으로 분류할지’, ‘긴 문서에서 무엇을 중심으로 요약할지’처럼 작업마다 달라지는 방법은 해당 작업의 스킬로 분리할 수 있다.

어떤 일을 할 때마다 필요한 설명을 처음부터 다시 하는 대신 그 작업에 필요한 지침과 순서만 따로 묶어 ‘이 일을 할 때는 이렇게 해’라고 미리 만들어 두는 것이 클로드 스킬이다.

CLAUDE.md와 스킬을 같이 쓰면 구조가 보인다

여러 개의 자료를 받아 먼저 분류하고, 필요한 내용을 요약한 뒤 최종 문서를 만드는 작업을 생각해보자.

파일이 계속 들어오는 프로젝트라면 처음부터 역할을 나눠두는 편이 관리하기 쉽다.

project/
├─ CLAUDE.md
│
├─ original/
├─ working/
├─ reference/
├─ output/
│
└─ .claude/
   └─ skills/
      ├─ classify/
      │  └─ SKILL.md
      ├─ summarize/
      │  └─ SKILL.md
      └─ write/
         └─ SKILL.md

폴더 이름은 작업 환경에 맞게 바꿔도 된다. 이 예시에서는 파일마다 맡은 역할을 먼저 나눴다.

original에는 손대지 않을 원본을 두고, working에서는 실제 작업을 진행한다. reference는 판단할 때 참고하는 자료, output은 완성된 결과를 모아두는 공간이다.

프로젝트 전체에서 계속 지켜야 하는 기준은 CLAUDE.md에 둘 수 있다.

# 프로젝트 작업 기준

- original은 원본 보관용이며 수정하지 않는다.
- working에서 실제 작업을 진행한다.
- reference의 자료는 작업 판단에 참고한다.
- 완료된 결과는 output에 저장한다.

# 작업 구분

- 자료 분류에는 classify 스킬을 사용한다.
- 긴 자료 요약에는 summarize 스킬을 사용한다.
- 결과 문서 작성에는 write 스킬을 사용한다.

이렇게 두면 `CLAUDE.md`는 프로젝트 전체의 작업 범위와 공통 기준을 맡고, 각 스킬은 자기 작업의 세부 방법을 맡는다.

CLAUDE.md가 ‘이 프로젝트에서 무엇을 지킬지’를 정한다면, 스킬은 ‘그 일을 어떤 방법으로 처리할지’를 맡는다.

원본을 건드리지 않는 기준은 분류·요약·작성 어느 단계에서도 유지돼야 한다.

반대로 분류 기준이나 요약 방법은 그 작업에서만 필요하다.

둘을 나눠두면 프로젝트 전체 구조를 건드리지 않고도 분류 절차나 요약 방식만 따로 고쳐서 관리할 수 있다.

스킬 하나는 실제로 어떻게 생겼을까

프로젝트용 스킬은 .claude/skills/스킬이름/ 아래에 SKILL.md를 두는 형태로 만들 수 있다.

앞의 프로젝트에서 자료 분류를 맡는 classify를 아주 단순하게 만든다면 다음과 비슷하다.

.claude/
└─ skills/
   └─ classify/
      └─ SKILL.md

SKILL.md에는 이 스킬이 어떤 작업에 쓰이는지와 실제 작업 방법을 적는다.

---
description: 여러 자료를 주제와 유형에 따라 분류할 때 사용
---

# 작업 방법

1. working의 작업 대상 파일을 확인한다.
2. reference에 분류 기준이 있다면 먼저 확인한다.
3. 각 자료의 주제와 유형을 구분한다.
4. 분류하기 애매한 자료는 별도로 표시한다.
5. 분류 결과를 output에 저장한다.

내용을 보면 거창한 기능은 아니다. 이 스킬은 분류할 때 필요한 작업 방법만 갖고 있다.

문서 작성 방식이나 요약 분량까지 집어넣지 않았기 때문에 분류 방법을 고치고 싶을 때도 이 스킬만 보면 된다.

필요하면 작업에 참고할 기준이나 자료도 스킬에 함께 둘 수 있다.

예를 들어 분류 기준표를 매번 참고해야 한다면 스킬 폴더를 이런 식으로 구성할 수도 있다.

classify/
├─ SKILL.md
└─ reference/
   └─ classification-guide.md

SKILL.md에는 작업 순서를 두고, classification-guide.md에는 실제로 참고할 분류 기준을 두는 식이다.

작성 스킬이라면 용어 기준이나 문서 형식을 참고자료로 붙일 수도 있다.

처음부터 스크립트나 여러 보조 파일을 잔뜩 넣을 필요는 없다. 실제로 같은 작업을 반복하면서 늘 확인하는 기준이나 자료가 생길 때 함께 묶으면 된다.

스킬은 요청 내용과 스킬 설명이 맞을 때 Claude가 사용할 수 있고, 특정 스킬을 바로 쓰고 싶다면 /classify처럼 직접 실행할 수도 있다.

초보자라면 자동으로 잘 골라주는지부터 신경 쓰기보다 스킬 하나가 맡는 일을 분명하게 나누는 것부터 시작하는 편이 낫다.

같은 프로젝트에서도 스킬은 역할별로 나눌 수 있다

자료 30개를 받아 최종 결과 문서 하나를 만드는 상황을 생각해보자.

처음부터 “이 자료를 전부 분석해서 결과 문서를 만들어줘”라고 맡겨도 된다. 한 번 하고 끝날 일이라면 그게 더 빠를 수 있다.

비슷한 작업이 계속 생긴다면 중간 과정을 나눠둘 이유가 생긴다.

자료 원본
   ↓
classify
주제와 유형에 따라 자료 분류
   ↓
summarize
필요한 자료의 핵심 내용 정리
   ↓
write
요약 결과와 참고자료를 이용해 문서 작성
   ↓
output
완성 결과 저장

classify에서는 어떤 자료가 어느 그룹에 들어가는지만 판단한다.

summarize에서는 선별된 자료 안에서 핵심 내용과 중요한 수치를 정리한다.

write에서는 앞에서 정리된 자료와 참고 기준을 가지고 최종 결과물을 만든다.

이렇게 나눠두면 항상 세 단계를 전부 실행할 필요도 없다.

이미 자료 분류가 끝났다면 요약부터 시작하고, 요약된 자료가 준비돼 있다면 작성 스킬만 사용할 수 있다.

스킬은 작업의 목적이 바뀌는 지점에서 나누면 된다.

분류하는 일과 요약하는 일은 같은 자료를 다루더라도 판단 기준이 다르고, 결과물을 작성하는 단계에서는 또 다른 지침이 필요하다.

회의 자료를 다룰 때도 비슷하다. 자료를 성격별로 나누고, 결정 사항과 일정을 요약한 다음, 최종 보고서를 만드는 흐름으로 나눌 수 있다.

공부 자료라면 단원별 분류, 핵심 요약, 복습 자료 작성으로 바꿀 수 있다. 하는 일은 달라도 ‘작업별 방법을 따로 둔다’는 구조는 그대로다.

모든 작업을 스킬로 만들 필요는 없다

매번 목표와 판단 기준이 크게 달라지는 일은 굳이 스킬로 고정할 이유가 없다.

반대로 같은 일을 할 때마다 “먼저 이 자료를 보고, 이런 기준으로 나눈 다음, 마지막에는 이 형식으로 저장해줘”라는 설명을 반복하고 있다면 스킬로 분리할 만하다.

프로젝트 지침이 길어지면서 지금 하는 작업과 관계없는 설명까지 한곳에 쌓이는 것도 신호다.

모든 기준을 CLAUDE.md 하나에 계속 추가하기보다 프로젝트 전체 규칙은 그대로 두고, 반복되는 작업 방법만 따로 빼는 쪽이 관리하기 편하다.

처음에는 자주 하는 작업 하나만 골라도 충분하다. 일을 시작할 때마다 적는 설명이 비슷하다면 그 문장을 모아보자.

프로젝트 전체에서 계속 지킬 기준과 특정 작업에서만 필요한 절차가 어느 부분에서 갈리는지 드러난다.

같은 질문을 반복하는지가 아니라, 같은 작업 방법을 반복해서 설명하고 있는지를 보면 된다.

---

클로드 활용, 매번 같은 지시를 반복한다면?

클로드 활용, Claude Code는 개발자만 쓰는 걸까?

참고자료와 출처
Anthropic Claude Code – Skills 구조, SKILL.md와 호출 방식