Claude Code Skills 가이드

개요

Skills(스킬) 는 Claude가 특정 작업을 더 잘 수행할 수 있도록 돕는 재사용 가능한 커스텀 기능입니다. Skills는 지침, 스크립트, 리소스를 포함하는 폴더 형태로, Claude가 필요할 때 자동으로 로드합니다.

Claude는 작업과 관련이 있을 때만 스킬에 접근합니다. 스킬이 사용되면 Claude는 Excel 작업이나 조직의 브랜드 가이드라인 준수와 같은 전문 작업을 더 잘 수행하게 됩니다.

Skills란 무엇인가?

핵심 정의

Skills are folders that include instructions, scripts, and resources that Claude can load when needed.

스킬은 폴더 형태로, 다음을 포함합니다:

지침 (Instructions)
스크립트 (Scripts)
리소스 (Resources)

동작 방식

작업을 수행하는 동안 Claude는 사용 가능한 스킬을 스캔하여 관련 항목을 찾습니다. 일치하는 항목이 있으면 필요한 최소한의 정보와 파일만 로드하여 Claude를 빠르게 유지하면서 전문 지식에 접근합니다.

Skills의 4가지 핵심 특징

1. Composable (구성 가능)

스킬은 서로 결합할 수 있습니다. Claude가 필요한 스킬을 자동으로 식별하고 사용을 조율합니다.

2. Portable (이식 가능)

스킬은 모든 곳에서 동일한 형식을 사용합니다. 한 번 빌드하면 Claude 앱, Claude Code, API에서 모두 사용할 수 있습니다.

3. Efficient (효율적)

필요할 때 필요한 것만 로드합니다.

4. Powerful (강력함)

스킬은 토큰 생성보다 전통적인 프로그래밍이 더 신뢰할 수 있는 작업을 위해 실행 가능한 코드를 포함할 수 있습니다.

Skills vs Commands 차이

특징	Skills	Commands
위치	`.claude/skills/` 또는 `~/.claude/skills/`	`.claude/commands/`
호출 방식	자동 (관련성 있을 때)	수동 (`/command` 입력)
능력	코드 실행 가능	지시사항 전달
형태	폴더 (SKILL.md + 스크립트 + 리소스)	단일 파일 (.md)
용도	전문 지식 패키징	특정 작업 수행

비유로 이해하기

Commands: "이 작업을 해"라고 말하는 지시서
Skills: 새로운 기능을 갖춘 도구를 장착하는 것

Skills 폴더 구조

기본 구조

.claude/
└── skills/
    └── my-custom-skill/
        ├── SKILL.md           # 스킬 설명 (필수)
        ├── script.py          # 실행 가능 코드 (선택)
        ├── config.json        # 설정 파일 (선택)
        └── resources/         # 필요한 리소스 (선택)
            ├── template.txt
            └── data.json

SKILL.md 예시

# Excel 분석 스킬

## 설명
Excel 파일을 읽고 분석하여 보고서를 생성합니다.

## 사용 시나리오
- 금융 데이터 분석
- 판매 보고서 생성
- 이상치 감지

## 실행 방법
1. Excel 파일 업로드
2. 분석 기준 선택
3. 보고서 형식 지정

Claude Code에서 Skills 사용

설치 방법

1. 플러그인 마켓플레이스 통해 설치

# anthropics/skills 마켓플레이스에서 설치
claude skill install <skill-name>

2. 수동 설치

# ~/.claude/skills/ 또는 프로젝트/.claude/skills/에 폴더 복사
cp -r my-custom-skill ~/.claude/skills/

3. 팀 공유 (버전 관리)

# 프로젝트 repository에 포함
git add .claude/skills/my-custom-skill/
git commit -m "Add custom skill"

자동 로딩

Claude는 작업의 맥락을 분석하여 관련 스킬을 자동으로 찾아서 로드합니다:

사용자: "이 Excel 파일의 이상치를 찾아줘"
       ↓
Claude: 관련 스킬 스캔 → "excel-analyzer" 스킬 발견
       ↓
Claude: 스킬 로드 및 코드 실행 → 결과 반환

왜 Skills가 반복 작업을 줄여주는가?

문제: 매번 같은 프롬프트 작성

이전 방식:

사용자: "Excel 파일을 읽고, A열의 합계를 구하고,
        이상치를 찾고, 그래프를 그려줘.
        형식은 우리 회사 표준을 따르고..."

→ 복잡한 작업마다 매번 상세한 프롬프트 필요

해결: Skills로 패키징

Skills 방식:

사용자: "이 Excel 파일 분석해줘"
       ↓
Claude: "excel-analyzer" 스킬 자동 로드
       → 이미 모든 지침과 코드가 포함됨

실제 예시

Excel 분석 스킬

한 번만 만들면:

데이터 읽기 방법
분석 로직
보고서 형식
회사 표준 준수

계속 재사용:

"이 파일 분석해줘"
"저 파일도 분석해줘"
매번 동일한 품질의 결과

Skills 생성 방법

1. skill-creator 스킬 사용 (간편)

Claude 앱에서 제공하는 "skill-creator" 스킬을 사용하면:

Claude가 워크플로우에 대해 질문
폴더 구조 자동 생성
SKILL.md 파일 자동 포맷팅
필요한 리소스 번들링
수동 파일 편집 불필요

2. 수동 생성

1. 폴더 생성
2. SKILL.md 작성 (스킬 설명)
3. 필요한 스크립트 작성
4. 리소스 추가
5. ~/.claude/skills/에 배치

모든 Claude 제품에서 Skills 사용

Claude Apps

Pro, Max, Team, Enterprise 사용자 가능
문서 생성을 위한 기본 스킬 제공
커스텀 스킬 생성 가능
설정에서 Skills 활성화 필요

Claude Developer Platform (API)

Messages API 요청에 스킬 추가 가능
/v1/skills 엔드포인트로 스킬 버전 관리
Code Execution Tool 베타 필요

Claude Code

anthropics/skills 마켓플레이스에서 플러그인으로 설치
관련 있을 때 자동 로딩
버전 관리로 팀 공유
~/.claude/skills에 수동 설치 가능

보안 고려사항

⚠️ 중요: Skills는 Claude에 코드 실행 권한을 부여합니다.

안전 지침:

신뢰할 수 있는 출처의 스킬만 사용
불명확한 스킬은 코드 리뷰 후 사용
조직의 보안 정책 준수
민감한 데이터 처리 스킬는 특별 주의

실전 활용 예시

1. 비즈니스 워크플로우 자동화

금융 보고서 생성 스킬:

입력: 원본 데이터 스프레드시트
처리: 이상치 감지 → 요약 생성 → 형식 지정
출력: 회사 표준 보고서

결과: 하루 걸리던 작업 → 1시간으로 단축

2. 조직 표준 준수

브랜드 가이드라인 스킬:

문서 생성 시 자동으로 회사 템플릿 적용
색상, 폰트, 로고 자동 준수
일관된 출력 보장

3. 전문 도구 통합

Excel/PowerPoint/Word 스킬:

전문적인 수식 포함 스프레드시트 생성
PowerPoint 프레젠테이션 작성
Word 문서 생성
채우기 가능한 PDF 생성

요약

Skills의 핵심 가치

재사용성: 한 번 만들면 계속 사용
자동화: Claude가 자동으로 찾아서 사용
전문화: 조직의 전문 지식을 패키징
확장성: 코드 실행으로 기능 확장
이식성: 모든 Claude 제품에서 사용

반복 작업 감소의 핵심

"Think of Skills as custom onboarding materials that let you package expertise, making Claude a specialist on what matters most to you."

스킬은 Claude를 당신에게 가장 중요한 것의 전문가로 만드는 커스텀 온보딩 자료입니다.