같은 Claude를 쓰는데, 왜 결과가 이렇게 다를까?
혹시 이런 경험 있으신가요?
Claude에게 뭔가를 시킬 때마다 매번 긴 프롬프트를 처음부터 다시 쓰는 경험이요. "저번에도 똑같이 설명했는데..." 싶으면서도 어쩔 수 없이 또 복붙하고, 또 맥락을 설명하고. 분명 같은 Claude를 쓰는데 어떤 사람은 한 마디면 원하는 결과를 딱 뽑아냅니다. 그 차이가 어디서 오는 걸까요?
정답은 Claude Skills에 있습니다. 이 글에서는 Claude Skills가 뭔지, 프롬프트와 뭐가 다른지, 어떻게 시작하는지, 그리고 제가 실제로 어떻게 활용하고 있는지까지 한 번에 정리해 드리겠습니다.
Claude Skills, 도대체 뭔가요?
한 줄로 말하면, Claude에게 업무 매뉴얼을 주는 것입니다.
신입사원이 들어오면 업무 매뉴얼부터 건네잖아요. "보고서는 이 양식으로 써", "코드 리뷰는 이 기준으로 해"라고요. Claude Skills도 같은 원리입니다. 특정 작업을 어떻게 수행해야 하는지를 한 번 정리해 두면, Claude가 그걸 읽고 매번 일관된 방식으로 작업을 수행합니다. Anthropic이 2025년 10월에 공개한 기능이고, 실체는 생각보다 단순합니다. 폴더 안에 SKILL.md라는 마크다운 파일을 만들고, 거기에 워크플로를 자연어로 설명하면 끝입니다.
그런데 왜 이게 필요한 걸까요? 프롬프트 잘 쓰면 되는 거 아닌가요?
여기서 컨텍스트 윈도우라는 개념을 알아야 합니다. 컨텍스트 윈도우란 AI가 한 번의 대화에서 읽고 처리할 수 있는 정보의 총량입니다. 쉽게 비유하면, 책상 위에 올려놓을 수 있는 서류의 양이라고 생각하시면 됩니다. 책상이 아무리 넓어도(Claude의 컨텍스트 윈도우가 아무리 커도), 매번 같은 서류를 꺼내서 올려놓는 건 비효율적이죠. 프롬프트 엔지니어링의 근본적인 한계가 여기에 있습니다. 매번 맥락을 처음부터 설명해야 하고, 그만큼 정작 중요한 작업에 쓸 수 있는 공간이 줄어듭니다.
Claude Skills는 이 문제를 해결합니다. 반복되는 맥락과 워크플로를 한 번 정리해 두면, Claude가 필요할 때만 꺼내 읽는 방식으로 컨텍스트 윈도우를 효율적으로 씁니다. 매번 긴 프롬프트를 복붙할 필요가 사라지는 거죠.
프롬프트와 뭐가 다른 건데? (Skills의 작동 원리)
겉보기엔 둘 다 "AI에게 지시를 내리는 것"인데, 안에서 돌아가는 방식이 완전히 다릅니다.
프롬프트는 대화가 시작될 때마다 리셋됩니다. 아무리 정교하게 작성해도, 새 대화를 열면 Claude는 이전에 뭘 했는지 기억하지 못합니다. Skills는 다릅니다. 한 번 만들어 두면 대화가 바뀌어도 항상 그 자리에 있습니다.
핵심은 점진적 로딩(Progressive Disclosure)이라는 구조입니다. Claude가 스킬을 읽는 과정은 3단계로 나뉩니다.
1단계 — 메타데이터 스캔.
Claude는 대화가 시작될 때 등록된 모든 스킬의 이름(name)과 설명(description)만 훑어봅니다. 스킬이 10개든 50개든 이 단계에서는 스킬 하나당 약 100토큰 정도만 씁니다. 책상 비유로 치면, 서랍에 붙어 있는 라벨만 읽는 거예요.
2단계 — SKILL.md 본문 로드.
사용자의 요청이 들어오면 Claude가 "이 작업이면 저 스킬이 필요하겠다"라고 판단합니다. 그때서야 해당 SKILL.md의 전체 지침을 불러옵니다. 서랍에서 매뉴얼을 꺼내 책상 위에 펼치는 단계입니다.
3단계 — 번들 리소스 로드.
스킬 폴더 안에 템플릿 파일, Python 스크립트, 예시 데이터 같은 추가 리소스가 있을 경우, Claude가 작업 중 필요하다고 판단한 것만 선택적으로 읽어 들입니다. 매뉴얼을 보다가 "아, 여기서 이 양식 서류가 필요하겠다" 싶을 때 서랍에서 하나 더 꺼내는 것과 같습니다.
그렇다면 SKILL.md 파일은 실제로 어떻게 생겼을까요? 구조는 생각보다 단순합니다.
---
name: weekly-report
description: 주간 업무 보고서를 팀 양식에 맞춰 작성합니다.
매주 보고서를 요청할 때 사용하세요.
---
# 주간 업무 보고서 작성 Skill
## 목적
이 Skill은 팀 표준 양식에 맞춰 주간 보고서를 작성합니다.
## 작성 규칙
- 분량: A4 1장 이내
- 구조: 이번 주 성과 → 다음 주 계획 → 이슈/리스크
- 톤: 간결한 문어체, 불릿 포인트 중심상단의 name과 description이 1단계에서 Claude가 훑어보는 부분입니다. 그 아래 마크다운 본문이 2단계에서 로드되는 실제 작업 지침이고요.
그리고 한 가지 더. 사용자가 스킬을 직접 호출할 필요가 없습니다. "주간 보고서 써줘"라고만 하면, Claude가 1단계에서 스캔했던 메타데이터를 바탕으로 알아서 적합한 스킬을 골라 실행합니다. 여러 스킬이 등록돼 있어도 상황에 맞는 것만 자동으로 조합해서 사용하죠. 매번 "이 스킬 써서 이렇게 해줘"라고 지정할 필요 없이, 평소처럼 요청만 하면 됩니다.
이게 프롬프트와의 결정적 차이입니다. 프롬프트는 매번 쓰고 버리는 일회용 메모지, Skills는 서랍에 꽂아두면 알아서 꺼내 쓰는 업무 매뉴얼입니다.
Claude Skills, 이렇게 시작하면 됩니다
이제 직접 써볼 차례입니다.
가장 쉬운 시작: 빌트인 스킬 활성화
Claude에는 Anthropic이 미리 만들어 둔 빌트인 스킬이 있습니다. Excel 스프레드시트 생성, PowerPoint 프레젠테이션, PDF 처리 같은 것들이에요. 설정 > 기능에서 스위치를 켜기만 하면 바로 쓸 수 있습니다.
별도로 호출할 필요도 없습니다. "Q3 매출 데이터로 프레젠테이션 만들어줘"라고 하면 Claude가 알아서 PowerPoint 스킬을 불러옵니다.
그 다음: 커스텀 스킬 만들기
빌트인 스킬만으로는 내 업무 방식을 반영할 수 없습니다. 진짜 레벨이 달라지는 건 커스텀 스킬을 직접 만들 때입니다. 폴더 구조는 이렇게 생겼습니다.
my-skill/
├── SKILL.md ← 핵심 지침 (필수)
├── templates/ ← 양식, 템플릿 (선택)
│ └── report-template.md
└── scripts/ ← Python/Bash 스크립트 (선택)
└── data-process.py필수 파일은 SKILL.md 하나뿐입니다. 본론 2에서 봤던 그 파일이에요. 나머지는 필요에 따라 추가하면 됩니다. 이 폴더를 ZIP으로 압축한 뒤, Claude 설정 > 기능 > Skills 업로드로 올리면 끝입니다.
스킬 만들기가 막막하다면: Skill Creator
"뭘 어떻게 써야 할지 모르겠다"라는 분들을 위해, Claude에는 Skill Creator라는 스킬이 내장돼 있습니다. 설정에서 활성화한 뒤 "이런이런 작업을 자동화하는 스킬 만들어줘"라고 요청하면, Claude가 질문을 던지면서 SKILL.md를 함께 만들어 줍니다. 스킬로 스킬을 만드는 셈이죠.
스킬의 진짜 가치: 재사용과 공유
한 번 만든 스킬은 계속 재사용할 수 있습니다. 오늘 만든 보고서 스킬을 다음 주에도, 다음 달에도 그대로 쓸 수 있어요. 그런데 여기서 끝이 아닙니다. Team이나 Enterprise 플랜을 사용하고 있다면, 잘 만든 스킬을 팀 전체에 공유할 수 있습니다. 조직의 소유자가 스킬을 프로비저닝하면 모든 팀원이 같은 스킬을 사용하게 됩니다.
이게 왜 중요하냐면, 스킬이 단순한 편의 기능을 넘어서 팀의 작업 표준이자 자산이 되기 때문입니다. 신입이 들어와도 스킬 하나 공유하면 팀의 업무 방식을 바로 따라갈 수 있고, 더 좋은 방법이 생기면 스킬을 업데이트해서 팀 전체의 생산성을 한 번에 올릴 수 있습니다. 개인의 노하우가 조직의 자산으로 바뀌는 거죠.
개발자H는 Claude Skills를 이렇게 씁니다
여기서부터는 제 이야기입니다.
저는 9-to-6 현직 개발자이면서 동시에 1인 비즈니스를 운영하고 있습니다. 뉴스레터, Threads, LinkedIn까지 콘텐츠 채널을 여러 개 돌리다 보니 반복 작업이 정말 많았습니다. Claude를 적극적으로 쓰고 있었지만, 매번 같은 맥락을 설명하는 데 시간을 쓰고 있었죠. 그래서 제 워크플로를 Skills로 만들기 시작했습니다. 현재 실제로 운영 중인 스킬 두 가지를 소개합니다.
사례 1. 콘텐츠 글감 생성 스킬 (content-idea-generator)
콘텐츠를 만들려면 가장 먼저 "오늘 뭘 쓰지?"부터 정해야 합니다. 이게 생각보다 오래 걸립니다.
도입 전: 매번 30분에서 1시간 이상을 주제 고민에 썼습니다. 노션 열어서 이전 글 목록 훑어보고, 트렌드 검색하고, "이건 너무 뻔한데... 이건 너무 좁은데..." 하면서 시간이 흘렀습니다. 정작 글을 쓸 시간은 줄어들었고요.
도입 후: "글감 생성해줘"라고 한 마디만 하면 됩니다. 1분이면 7개의 글감 헤드라인이 나옵니다.
어떻게 가능하냐면, 이 스킬 안에 제 콘텐츠 전략이 통째로 들어가 있기 때문입니다. 글 유형을 먼저 정하고, 핵심 포인트를 도출하고, 신뢰도를 판단한 뒤 헤드라인까지 만드는 4단계 로직을 스킬에 담아 뒀습니다. 제가 평소에 "좋은 글감이다"라고 판단하는 기준 — 예를 들면 독자의 구체적 문제를 건드리는지, 제 경험으로 뒷받침할 수 있는지 — 이런 기준들이 스킬 안에 녹아 있으니까 매번 다시 설명할 필요가 없습니다. Claude가 제 머릿속 판단 기준을 이미 알고 있는 셈이에요.
사례 2. SNS 콘텐츠 변환 스킬 (threads-conversion, linkedin-conversion)
저는 하나의 원본 콘텐츠를 뉴스레터, Threads, LinkedIn 등 여러 채널에 맞춰 발행합니다. 문제는 채널마다 톤, 포맷, 분량이 전부 다르다는 거였습니다.
도입 전: 불편한 점이 한두 가지가 아니었습니다. 우선 SNS 게시글 하나를 만드는 데 30분 이상 걸렸습니다. Claude에게 프롬프트를 매번 새로 써야 하니 톤이 들쭉날쭉했고요. Threads는 짧고 캐주얼하게, LinkedIn은 전문적이면서도 스토리텔링 중심으로 — 이 채널별 포맷을 매번 프롬프트에 녹이는 게 상당히 번거로웠습니다.
도입 후: 원본 콘텐츠 하나만 있으면, "Threads 변환해줘", "LinkedIn 변환해줘" 한 마디로 각 채널에 최적화된 게시글이 나옵니다. Threads용과 LinkedIn용을 동시에 만들 수 있게 된 거죠.
이게 가능한 이유는, 각 채널별 스킬에 톤, 포맷, 글자 수 제한, 해시태그 전략 같은 규칙을 다 정리해 뒀기 때문입니다. Threads 스킬에는 "짧고 임팩트 있게, 멀티스레드 포함"이라는 규칙이, LinkedIn 스킬에는 "전문적 톤, 경험 기반 스토리텔링 중심"이라는 규칙이 들어가 있습니다. 프롬프트를 다시 쓸 필요가 없으니 톤도 일관되고, 시간도 절반 이하로 줄었습니다.
정리하면 이런 차이입니다.
스킬 도입 전에는 "AI에게 매번 처음부터 부탁하는 것"이었습니다. 도입 후에는 "내 업무 방식을 이미 알고 있는 어시스턴트에게 한 마디로 지시하는 것"이 됐습니다. 똑같이 Claude를 쓰지만, 쓰는 방식이 완전히 다릅니다. 이게 제가 본문 서두에서 말씀드린 "AI 활용 레벨이 달라진다"의 실체입니다.
Claude Skills, 핵심만 정리합니다
다시 처음 질문으로 돌아가겠습니다. 같은 Claude를 쓰는데, 왜 결과가 다를까요?
Claude Skills는 AI에게 업무 매뉴얼을 주는 것입니다. 매번 프롬프트를 처음부터 쓰는 대신, 반복되는 워크플로를 한 번 정리해서 서랍에 넣어 두는 거죠. Claude는 점진적 로딩 구조로 필요한 스킬만 꺼내 쓰고, 컨텍스트 윈도우를 효율적으로 관리합니다. 빌트인 스킬로 바로 시작할 수 있고, 커스텀 스킬을 직접 만들면 내 업무 방식 그대로 AI가 움직입니다. 잘 만든 스킬은 혼자 쓰는 데서 끝나지 않고, 팀의 생산성을 높이는 자산이 됩니다.
AI를 쓰는 것과 AI를 내 방식으로 훈련시키는 것은 다릅니다. Claude Skills가 바로 그 차이입니다.
의견을 남겨주세요