Claude Code 스킬 완벽 가이드: AI 자동화로 업무 효율을 높이는 방법

핵심 요약

스타트업을 운영하면서 반복적인 작업에 시간을 소비하고 계신가요? Claude Code의 스킬 기능 을 활용하면 AI가 당신의 표준에 맞춰 일을 자동으로 처리하도록 만들 수 있습니다. 마치 전문가 팀원이 당신의 일하는 방식을 학습했을 때처럼 말이죠.

🎯 AI 자동화의 새로운 차원: 당신의 회사 표준과 프로세스를 AI에게 직접 가르칠 수 있습니다
⚡ 빠른 성장을 위한 필수 도구: 창업 초기 제한된 인력으로 최대한의 생산성을 끌어내는 방법
🔄 반복 작업 완전 제거: PR 검토, 커밋 메시지, 데이터 처리 등 모든 것을 자동화합니다
📈 확장 가능한 팀 문화: 회사가 성장해도 일관된 품질과 표준을 유지하는 방법

스킬은 단순한 자동화 도구가 아닙니다. 이것은 당신의 팀 노하우를 AI에 녹여내서, 언제든 필요한 순간에 당신의 표준대로 일을 처리해주는 디지털 팀원 을 만드는 것입니다. 특히 빠르게 성장하는 스타트업에서 일관된 품질을 유지하면서도 속도를 잃지 않아야 한다면, Claude Code 스킬은 정말 게임 체인저가 될 수 있습니다.

Claude Code 스킬이란? 스타트업이 반드시 알아야 할 이유

당신의 회사만의 방식이 있습니다. 코드 리뷰를 할 때 어떤 포인트를 중점적으로 보는지, 커밋 메시지를 어떤 형식으로 작성해야 하는지, 고객 데이터를 어떻게 처리하는지 말이죠.

Claude Code의 스킬 기능 은 이런 당신의 일하는 방식을 마크다운 파일에 기록해서 AI에게 가르치는 기능입니다. 일단 스킬을 만들어두면, 당신이 관련된 요청을 할 때마다 Claude는 자동으로 그 스킬을 인지하고 당신의 표준에 맞춰 일을 처리합니다.

예를 들어 생각해보세요. 당신이 "이 PR을 우리 팀 표준에 맞춰 검토해 줄래?"라고 요청했을 때, Claude가 자동으로 당신의 코드 리뷰 스킬을 활용해서, 당신이 항상 체크하던 포인트들을 정확히 검토해주는 겁니다. 이게 스킬의 힘입니다.

스킬을 사용하면 실제로 뭐가 좋을까요?

먼저 시간이 엄청나게 절약됩니다. 스타트업에서 가장 귀한 자산이 시간 아닌가요? PR 검토, 커밋 메시지 작성, 회의록 정리, 이메일 템플릿 생성 같은 반복 작업들을 AI가 당신의 스타일로 자동으로 처리해줍니다. 당신은 정말 중요한 의사결정에만 집중할 수 있게 되는 거죠.

둘째, 팀 문화와 표준이 일관되게 유지됩니다. 스타트업은 빠르게 사람이 늘어납니다. 새로 들어온 팀원들도 당신의 표준을 따라야 하는데, 이걸 일일이 가르치기는 정말 힘들죠. 하지만 스킬에 당신의 표준을 다 기록해두면? 새 팀원이 들어와도 AI가 일관된 피드백을 제공해서, 자연스럽게 팀 문화에 적응하게 됩니다.

셋째, 창의적인 일에 더 집중할 수 있습니다. 반복 작업에서 벗어나면, 당신과 팀원들은 제품 개선, 새로운 기능 기획, 고객 만족도 향상 같은 정말 중요한 일에 에너지를 쏟을 수 있습니다. 이게 바로 빠른 성장의 원동력이 되는 거죠.

스킬이 자동으로 작동하는 방식

여기가 정말 핵심입니다. 당신이 스킬을 명시적으로 호출할 필요가 없다 는 거죠.

예를 들어보겠습니다. 당신이 "우리 팀 표준에 맞춰서 이 PR을 검토해 줄래?"라고 요청했다고 가정해봅시다. Claude는 이 요청을 읽고, 'PR 검토'와 관련된 스킬이 있는지를 자동으로 찾습니다. 만약 당신이 "코드 리뷰" 스킬을 미리 만들어뒀다면, Claude는 그 스킬의 설명을 읽고 "아, 이 요청은 내가 만들어둔 스킬과 딱 맞네"라고 판단해서 자동으로 그 스킬을 활용합니다.

이런 자동 감지 때문에, 실제로 당신은 매번 /skill-name을 입력할 필요가 없습니다. Claude가 알아서 필요한 스킬을 찾아서 써줍니다. 마치 당신이 경험 많은 팀 리더에게 일을 맡길 때, 그 리더가 어떤 체크리스트를 써야 할지 자동으로 판단해서 적용하는 것처럼요.

스킬 저장 위치: 어디에 저장하느냐가 중요한 이유

스킬을 만들었다면, 이제 어디에 저장할지 결정해야 합니다. 그리고 어디에 저장하느냐에 따라 누가 그 스킬을 사용할 수 있는지가 결정됩니다.

당신이 스타트업을 운영 중이라면, 아마도 이 세 가지 중 하나를 선택하게 될 겁니다.

첫 번째는 개인 폴더에 저장하는 방식 입니다. ~/.claude/skills/라는 개인 폴더에 스킬을 저장하면, 당신이 모든 프로젝트에서 그 스킬을 사용 할 수 있습니다. 혼자 일하거나, 개인적인 생산성 도구를 만들고 싶을 때 좋습니다. 예를 들어 당신만의 글쓰기 스타일을 정의해서, 모든 프로젝트에서 일관되게 적용하고 싶을 때 말이죠.

두 번째는 프로젝트 폴더에 저장하는 방식 입니다. .claude/skills/라는 프로젝트 내 폴더에 스킬을 저장하면, 그 프로젝트에 참여하는 모든 사람이 그 스킬을 사용 할 수 있습니다. 여기가 스타트업에서 정말 강력한 부분입니다. 당신의 프로젝트 표준을 스킬로 정의해두고, 팀 전체가 그 스킬을 공유하면서, 일관된 품질을 유지할 수 있거든요. Git으로 버전 관리도 되니까, 스킬이 변경되면 자동으로 모두에게 반영됩니다.

세 번째는 엔터프라이즈 레벨 입니다. 더 커진 회사라면, 관리 설정을 통해 조직 전체에 스킬을 배포할 수 있습니다. 이건 회사가 어느 정도 크기가 되었을 때 고려하는 방식이죠.

당신이 지금 스타트업이라면, 프로젝트 폴더 방식이 가장 효과적 입니다. 팀이 작으니까 프로젝트에 참여하는 사람들이 전부이고, 스킬을 통해 모두가 동일한 표준으로 일할 수 있거든요.

첫 번째 스킬 만들기: 실제로는 생각보다 간단합니다

자, 이제 실제로 스킬을 만들어봅시다. 스킬이 무엇인지, 어디에 저장하는지는 이해했으니까요.

스킬을 만드는 방식은 정말 간단합니다. 마크다운 파일 하나만 있으면 됩니다. SKILL.md라는 이름의 파일에 두 가지만 넣으면 되는 거죠:

맨 위에 설정 정보 (YAML 형식)
아래에 설명과 지침 (마크다운)

예를 들어, 당신이 팀원들이 "우리 스타일로 코드를 설명해 줄래?"라고 요청할 때마다, Claude가 시각적 다이어그램과 쉬운 비유를 섞어서 설명하는 스킬을 만들고 싶다고 해봅시다.

---
name: visual-code-explanations
description: ASCII 다이어그램과 현실적인 비유를 사용해서 코드를 설명합니다. 
코드를 이해하기 쉽게 설명해달라거나, 복잡한 개념을 직관적으로 알려달라고 요청할 때 사용하세요.
---

# 시각적 코드 설명

## 지침

코드를 설명할 때는 항상:
1. ASCII 다이어그램으로 구조를 표현하기
2. 실제 생활 사례와 비교하기
3. 단계별로 어떻게 작동하는지 보여주기

## 예시

메모리 관리 개념을 설명할 때:

┌─────────────────────┐
│ RAM (메모리) │
├─────────────────────┤
│ [A][B][C][D][E] │ ← 데이터가 순서대로 저장됨
├─────────────────────┤
│ 사용 가능한 공간 │
└─────────────────────┘

이건 도서관 책장처럼 생각하면 됩니다.
책(데이터)을 순서대로 놓고, 필요하면 꺼내쓰고,
다 썼으면 제자리에 돌려놓는 거죠.


이런 식으로 설명하면, 팀원들도 훨씬 쉽게 이해합니다.

어때요? 정말 간단하죠? 당신이 해야 할 일은 그냥 당신의 일하는 방식을 마크다운으로 설명하는 것뿐입니다.

그리고 이 파일을 .claude/skills/visual-code-explanations/SKILL.md에 저장해두면 끝입니다. 그 다음부터 당신의 팀원들이 "코드를 이해하기 쉽게 설명해 줄래?"라고 요청하면, Claude가 자동으로 이 스킬을 감지해서 시각적 다이어그램과 비유를 섞어서 설명해줍니다.

스킬의 설정 정보 (YAML) 이해하기

스킬의 맨 위 --- 사이에 있는 정보들은 모두 무엇일까요? 이건 Claude에게 스킬의 기본 정보를 알려주는 거예요.

name - 이건 스킬의 이름입니다. 소문자와 하이픈만 사용하고, 최대 64자입니다. 폴더 이름과도 같아야 하죠.

description - 이건 정말 중요합니다. Claude가 이 설명을 읽고 당신의 요청과 스킬이 맞는지를 판단하거든요. 따라서 설명할 때는 두 가지를 꼭 포함해야 합니다:

"이 스킬은 뭘 하는 건가요?" - 구체적인 기능을 명시하세요
"언제 사용하나요?" - 사용자가 언급할 법한 키워드를 포함하세요

예를 들어, "코드 검토를 합니다"라는 설명은 너무 모호합니다. 대신 "팀의 코드 리뷰 표준에 따라 PR을 검토합니다. 성능 최적화, 보안, 코드 스타일을 중점으로 체크합니다"라고 구체적으로 쓰는 게 훨씬 좋습니다.

allowed-tools (선택사항) - 이건 이 스킬을 사용할 때 Claude가 어떤 도구를 사용할 수 있게 할지를 제한합니다. 예를 들어, 파일을 읽기만 하고 수정하지 않는 읽기 전용 스킬이라면, allowed-tools: Read, Grep, Glob이라고 지정해서 파일 쓰기 도구는 못 쓰게 할 수 있습니다.

model (선택사항) - 이 스킬을 사용할 때 특정 Claude 모델을 사용하게 할 수 있습니다. 예를 들어 특히 강력한 분석이 필요하면 더 새로운 모델을 지정할 수도 있습니다.

이런 설정들이 모여서, Claude가 스킬을 어떻게 사용해야 하는지를 결정하는 거예요.

스킬과 다른 자동화 도구들의 차이: 무엇을 언제 써야 할까?

Claude Code에는 스킬 외에도 여러 자동화 기능들이 있습니다. 슬래시 명령, CLAUDE.md, 서브 에이전트, MCP 서버 등등. 각각이 뭐고, 언제 써야 할지 헷갈릴 수 있으니까 정리해드릴게요.

스킬 (Skills) - 당신의 전문 지식을 Claude에게 가르칩니다. 당신이 요청할 때, Claude가 자동으로 관련 스킬을 감지해서 적용합니다. "우리 표준에 따라 PR을 검토해 줄래?"라고 요청하면, Claude가 자동으로 당신의 PR 검토 스킬을 써줍니다. 명시적으로 호출할 필요가 없죠.

슬래시 명령 (/command) - 이건 당신이 명시적으로 입력해야 하는 명령입니다. 매번 /deploy staging처럼 직접 입력해야 하죠. 반복하는 프롬프트를 빠르게 실행하고 싶을 때 좋습니다.

CLAUDE.md - 이건 프로젝트 전체에 적용되는 가이드라인입니다. "우리는 TypeScript를 사용한다", "모든 함수에는 주석이 있어야 한다" 같은 프로젝트 전반의 규칙을 써둡니다. 모든 대화에서 자동으로 로드되죠.

서브 에이전트 (Sub-agents) - 복잡한 작업을 별도의 전문 에이전트에게 위임합니다. 예를 들어 코드 분석 전문 에이전트, 문서 작성 전문 에이전트 같은 식으로, 특정 분야에 특화된 별도의 AI를 사용하는 거죠. 자체 도구와 컨텍스트를 가지고 독립적으로 작동합니다.

MCP 서버 (Model Context Protocol) - 이건 Claude를 외부 도구나 데이터 소스에 연결합니다. 예를 들어 회사의 데이터베이스, Slack, GitHub API 같은 것들을 직접 Claude에 연결해주는 거죠.

스타트업 초기에는 어떻게 사용할까요? 당신이 지금 작은 스타트업이라면:

스킬: 팀의 코드 리뷰 표준, 커밋 메시지 포맷, 문서 작성 스타일 같은 것들을 정의하세요. 팀원들이 일관된 방식으로 일하게 될 겁니다.
CLAUDE.md: 프로젝트의 기본 규칙들을 써둡니다. 기술 스택, 폴더 구조, 네이밍 컨벤션 같은 것들이죠.
슬래시 명령: 자주 하는 일들을 빠르게 실행합니다. /test, /deploy 같은 식으로요.

이 조합이면, 당신의 팀은 일관성 있으면서도 빠르게 일할 수 있습니다.

스킬 파일의 구조: 깔끔하게 정리하는 방법

간단한 스킬은 SKILL.md 파일 하나만 있으면 되지만, 복잡한 스킬을 만들 때는 여러 파일을 함께 사용하는 게 좋습니다. 이때 중요한 개념이 점진적 공개(Progressive Disclosure) 입니다.

이게 뭐냐면, SKILL.md 파일에는 핵심만 간략하게 써두고, 상세한 정보는 별도의 파일에 넣는 거죠. Claude가 필요할 때만 추가 파일을 읽게 하는 방식입니다.

예를 들어, PDF 파일을 처리하는 복잡한 스킬을 만든다면:

pdf-processing/
├── SKILL.md              # 전체 개요와 빠른 시작 가이드
├── FORMS.md              # 양식 필드 설명 (세부 사항)
├── REFERENCE.md          # API 상세 정보 (참고용)
└── scripts/
    ├── fill_form.py      # 유틸리티 스크립트
    └── validate.py       # 검증 스크립트

이렇게 구조화하면:

SKILL.md: "PDF 텍스트 추출, 양식 채우기, PDF 병합을 합니다. 당신이 PDF 작업을 할 때 사용하세요."라는 정도만 써둡니다. 이건 모든 대화에 로드되어 많은 토큰을 소비하지 않습니다.
FORMS.md, REFERENCE.md: 상세 정보는 여기에 써둡니다. SKILL.md에서 링크로 연결해두면, Claude가 필요할 때만 읽습니다.
scripts/: 실행하는 스크립트는 내용을 로드하지 않고 실행만 합니다. 따라서 토큰을 거의 소비하지 않으면서도 실제로 작동하는 검증된 코드를 사용할 수 있습니다.

이 방식의 가장 큰 장점은 컨텍스트 창을 효율적으로 사용 한다는 거예요. Claude의 컨텍스트 창(한 번에 처리할 수 있는 정보량)은 제한되어 있습니다. 스킬이 복잡할수록 더 많은 정보를 로드하게 되고, 그러면 실제 작업에 쓸 수 있는 공간이 줄어듭니다. 따라서 필수 정보만 남기고 상세 정보는 필요할 때만 로드하는 것이 전략적으로 중요합니다.

스타트업이 이것을 놓치기 쉬운 부분 인데, 처음엔 간단하게 시작하다가 스킬이 복잡해지면, 이렇게 구조화하면 정말 큰 차이가 납니다. 특히 여러 복잡한 스킬을 동시에 사용할 때요.

스킬의 도구 접근 제한: 보안을 고려한 설계

당신이 만드는 스킬이 중요한 작업을 처리한다면, 보안이 중요합니다. 예를 들어, "파일을 읽어서 분석만 하고 절대 수정하지 않는 스킬"을 만들고 싶을 수도 있고, "특정 도구만 사용하고 나머지는 못 쓰게" 제한하고 싶을 수도 있습니다.

이때 allowed-tools 필드를 사용합니다.

---
name: reading-files-safely
description: 파일을 읽어서 분석합니다. 파일을 수정하지 않습니다. 
읽기 전용 분석이 필요할 때 사용하세요.
allowed-tools: Read, Grep, Glob
---

이렇게 지정하면, 이 스킬이 활성화되었을 때 Claude는 Read (파일 읽기), Grep (내용 검색), Glob (파일 찾기) 이 세 가지 도구만 사용할 수 있습니다. 파일을 쓰는 도구, 코드를 실행하는 도구 등은 사용할 수 없게 됩니다.

이건 특히 다음과 같은 상황에서 중요합니다:

읽기 전용 분석: "우리 로그 파일을 분석해 줄래? 하지만 절대 수정하면 안 돼"라는 스킬을 만들 때, 파일 쓰기 도구를 차단할 수 있습니다.

제한된 범위 스킬: "데이터 분석은 가능하지만, 파일을 저장할 순 없게" 제한할 수 있습니다.

보안이 중요한 워크플로우: 예를 들어 금융 데이터 처리, 개인정보 처리 같은 민감한 작업일 때, 스킬에서 쓸 수 있는 도구를 엄격하게 제한합니다.

포크된 컨텍스트: 복잡한 작업을 격리된 환경에서 실행

가끔 정말 복잡한 작업을 처리해야 할 때가 있습니다. 예를 들어, 긴 분석 결과를 작성하고 중간에 여러 번 계산을 하고, 데이터를 확인하고, 최종 보고서를 만드는 작업이라면?

이런 경우, 포크된 컨텍스트(forked context) 를 사용합니다. 이건 스킬을 별도의 격리된 환경에서 실행하는 거예요. 자체 대화 기록과 자체 컨텍스트 창을 가지고 작동합니다.

---
name: detailed-analysis
description: 복잡한 데이터를 깊이 있게 분석하고 상세 보고서를 작성합니다.
context: fork
---

이렇게 하면:

격리된 작업 공간: 이 스킬이 실행될 때, 자체 컨텍스트 창을 가지고 작동합니다. 따라서 주 대화를 복잡하게 만들지 않습니다.
자체 대화 기록: 스킬 내에서 여러 번의 대화와 분석을 거쳐도, 그 과정이 주 대화에 영향을 주지 않습니다.
효율적인 리소스 사용: 복잡한 작업과 간단한 작업을 분리하면, 각각 리소스를 효율적으로 사용할 수 있습니다.

스타트업에서 언제 이걸 쓸까요?

월간 리포트 자동 생성: 여러 데이터를 수집하고, 분석하고, 최종 리포트를 작성하는 복잡한 작업
코드 품질 평가: 여러 지표를 계산하고 비교 분석해서 최종 등급을 매기는 작업
고객 데이터 처리: 긴 고객 데이터를 분석해서 인사이트를 도출하는 작업

이런 경우들에서 포크된 컨텍스트를 사용하면, 메인 업무 흐름을 방해하지 않으면서 복잡한 분석을 할 수 있습니다.

스킬 배포: 팀 전체가 사용하게 하는 방법

스킬을 만들었으니, 이제 팀원들도 사용하게 해야 합니다. 당신은 혼자가 아니니까요.

가장 간단한 방법은 프로젝트 폴더에 저장하는 것 입니다. .claude/skills/my-skill/SKILL.md에 저장하면, 이 프로젝트에 참여하는 모든 팀원이 자동으로 그 스킬을 사용할 수 있습니다. Git으로 버전 관리도 되니까, 스킬을 수정하면 자동으로 모두에게 반영됩니다.

예를 들어, 당신의 팀이 GitHub에서 협업하고 있다면:

리포지토리의 .claude/skills/ 폴더를 만듭니다
각 스킬을 별도 폴더에 넣습니다 (.claude/skills/pr-review/SKILL.md, .claude/skills/commit-helper/SKILL.md 등)
Git에 커밋하고 푸시합니다
팀원들이 저장소를 받으면, 그들도 자동으로 그 스킬들을 사용할 수 있습니다

더 큰 규모의 배포: 회사가 커지면, 플러그인 마켓플레이스를 통해 여러 팀 전체에 스킬을 배포할 수도 있습니다. 또는 관리자가 관리형 설정을 통해 조직 전체에 스킬을 배포할 수도 있죠.

하지만 당신이 지금 스타트업이라면, 프로젝트 폴더 방식으로 시작하는 게 가장 효과적 입니다. 간단하면서도 팀 전체에 일관된 표준을 배포할 수 있거든요.

실제 예시: 스타트업이 자주 쓰는 스킬들

이론만으로는 어떻게 써야 할지 모호할 수 있으니, 실제 예시를 들어보겠습니다.

예시 1: 커밋 메시지 생성 스킬

---
name: commit-message-generator
description: 스테이징된 변경 사항을 분석해서 우리 팀 표준에 맞는 
커밋 메시지를 생성합니다. 커밋 메시지 작성이 필요할 때 사용하세요.
allowed-tools: Bash
---

# 커밋 메시지 생성기

## 지침

1. `git diff --staged`를 실행해서 변경 사항을 확인합니다
2. 다음 포맷으로 커밋 메시지를 작성합니다:
   - **제목**: 50자 이내, 현재 시제, 영문
   - **본문**: 변경 이유와 영향 범위
   - **꼬리말**: `Closes #123` 형식의 이슈 연결

## 예시

Bad: "fixed bug"
Good: "Fix null pointer exception in user authentication"

본문:
- 왜 이 변경이 필요했는지
- 어떤 영향을 미치는지

이렇게 하면 나중에 git log를 볼 때, 각 커밋이 왜 존재하는지 
바로 이해할 수 있습니다.

이렇게 스킬을 만들어두면, 팀원이 "커밋 메시지 만들어 줄래?"라고 요청하면, Claude가 자동으로 변경 사항을 분석해서 당신의 표준에 맞는 메시지를 제안해줍니다.

예시 2: PR 검토 스킬

---
name: pr-review
description: 우리 팀의 코드 리뷰 표준에 따라 PR을 검토합니다. 
코드 품질, 성능, 보안, 테스트 커버리지를 확인합니다.
당신의 PR을 검토해달라고 요청할 때 사용하세요.
---

# PR 검토 스킬

## 검토 포인트

### 1. 코드 품질 (필수)
- 변수명이 의미가 있는지
- 함수가 한 가지 일만 하는지
- 코드 중복이 없는지

### 2. 성능 (필수)
- 반복문 안의 불필요한 연산이 없는지
- 데이터베이스 쿼리가 최적화되었는지

### 3. 보안 (필수)
- SQL injection 위험이 없는지
- 입력 검증이 충분한지
- 민감한 정보가 노출되지 않았는지

### 4. 테스트
- 새로운 기능에 대한 테스트가 있는지
- 기존 테스트가 깨지지 않았는지

## 리뷰 결과 포맷

각 포인트마다:
- ✅ Pass: 문제 없음
- ⚠️ Warning: 개선 권장
- ❌ Fail: 수정 필수

이렇게 하면, 팀원들도 일관되게 피드백을 받고, 
시간이 지나도 코드 품질이 일정하게 유지됩니다.

예시 3: 기술 블로그 문법 검사 스킬

---
name: blog-quality-checker
description: 기술 블로그 글의 품질을 확인합니다. 
문법, 명확성, 기술적 정확성을 검토합니다.
블로그 글을 검토해달라고 요청할 때 사용하세요.
allowed-tools: Read
---

# 블로그 품질 검사기

## 검사 항목

### 명확성
- 문장이 명확한가?
- 용어 설명이 충분한가?
- 독자가 이해하기 쉬운가?

### 기술적 정확성
- 코드 예시가 작동하는가?
- 설명이 기술적으로 정확한가?
- 최신 정보인가?

### 구조
- 목차가 명확한가?
- 섹션 구분이 논리적인가?
- 예시가 충분한가?

검사 후 개선 제안과 함께 재작성 버전도 제안합니다.

이런 스킬들을 만들어두면, 당신의 팀은:

일관된 품질: 누가 하던 같은 수준의 코드, 같은 포맷의 커밋, 같은 품질의 문서를 만들게 됩니다.
빠른 피드백: PR 검토나 문서 검토를 할 때 Claude가 자동으로 체크리스트를 따르니까, 빠르고 놓치는 게 없습니다.
학습 효과: 새 팀원들이 이 스킬들을 보면서, 팀의 표준이 뭔지 자연스럽게 배웁니다.

스킬이 작동하지 않을 때: 문제 해결

스킬을 만들었는데 작동하지 않는다면? 몇 가지 확인해야 할 것들이 있습니다.

첫 번째, 파일 경로를 확인하세요. 스킬은 정확한 파일명 SKILL.md (대소문자 구분)로 올바른 위치에 있어야 합니다. 경로 예:

개인: ~/.claude/skills/my-skill/SKILL.md
프로젝트: .claude/skills/my-skill/SKILL.md

두 번째, YAML 문법을 확인하세요. 프런트매터의 --- 표시가 정확한지, 들여쓰기가 공백(탭 아님)으로 되어 있는지 확인합니다. YAML 문법 오류는 스킬 전체를 로드하지 못하게 합니다.

세 번째, 스킬 설명이 명확한지 확인하세요. "문서 작업 지원"처럼 모호한 설명은 Claude가 당신의 요청과 스킬이 맞는지 판단하지 못합니다. 설명할 때는:

구체적인 기능을 명시하세요 ("PDF 텍스트 추출, 양식 채우기, PDF 병합")
사용자가 언급할 법한 키워드를 포함하세요 ("PDF 파일 작업할 때")

네 번째, 스킬이 로드되었는지 확인하세요. Claude에게 "지금 사용 가능한 스킬이 뭐가 있어?"라고 물어보면, 현재 로드된 모든 스킬을 나열해줍니다. 당신의 스킬이 목록에 있는지 확인하세요.

다섯 번째, 스킬이 활성화되도록 요청하세요. 스킬 설명과 정확히 맞는 요청을 하세요. 예를 들어, PR 검토 스킬이라면 "우리 팀 표준에 맞춰서 이 PR을 검토해 줄래?"라고 요청하세요. 너무 일반적인 요청 ("코드 봐 줄래?")은 스킬을 트리거하지 못할 수 있습니다.

결론: 스킬로 시작하는 AI 자동화

스타트업은 속도와 일관성 사이에서 균형을 맞춰야 합니다. 빠르게 성장해야 하지만, 품질도 떨어지면 안 되니까요.

Claude Code의 스킬 기능은 이 두 가지를 모두 가능하게 해줍니다. 당신의 일하는 방식을 AI에 학습시켜두면, 팀원들은 더 중요한 일에 집중할 수 있고, AI가 반복적인 작업들을 일관되게 처리해줍니다.

지금 바로 시작해보세요:

당신의 팀이 반복하는 일이 뭔지 생각해보세요. PR 검토? 커밋 메시지? 문서 작성?
그 일의 표준을 마크다운으로 정리하세요. 체크리스트, 포맷, 중요 포인트들을요.
첫 번째 스킬을 만들어보세요. .claude/skills/ 폴더에 SKILL.md 파일을 만들고, 당신의 표준을 정의합니다.
팀과 공유하세요. Git에 커밋해서 모두가 사용하게 합니다.

이렇게 시작하면, 시간이 지날수록 당신의 팀은 점점 더 효율적이 되고, 새 팀원들도 자연스럽게 팀의 문화를 배우게 됩니다. 이게 바로 스킬의 진정한 가치입니다.

당신의 팀만의 "일하는 방식"을 AI에 녹여내세요. 그러면 당신의 팀은 더 빠르게, 더 일관되게 성장할 수 있습니다.

Original source: Agent Skills - Claude Code Docs

powered by osmu.app

Claude Code 스킬 완벽 가이드: AI 자동화 시작하기