Agent Skills - Claude Code Docs

원문: Agent Skills - Claude Code Docs

이 가이드는 Claude Code에서 Agent Skills를 생성, 사용 및 관리하는 방법을 보여줍니다. Skills는 지침, 스크립트 및 리소스를 포함하는 구성된 폴더를 통해 Claude의 기능을 확장하는 모듈식 기능입니다.

필수 조건

Claude Code 버전 1.0 이상
Claude Code에 대한 기본 지식
터미널(bash/zsh) 기본 사용법

Agent Skills의 핵심 개념

Agent Skills는 전문 지식을 발견 가능한 기능으로 패키징합니다. 각 Skill은 다음으로 구성됩니다:

SKILL.md: Claude가 필요할 때 자동으로 읽는 메타데이터와 상세 지침
선택적 지원 파일: 스크립트, 템플릿, 참고 자료 등

Skills와 Slash Commands의 차이

특성	Agent Skills (모델 호출)	Slash Commands (사용자 호출)
호출 방식	자동 - Claude가 필요를 감지하면 자율적으로 사용	수동 - 사용자가 `/command` 입력하여 명시적 호출
발견성	Skill 설명 기반으로 Claude가 자동 인지	사용자가 알아야 함
실행	조건에 맞을 때 자동 실행	명시적 요청 시에만 실행
사용 사례	특정 도메인 지식, 반복적 워크플로우	디버그 명령, 설정 변경

예시:

Skill: “PDF 파일 처리”를 설명하면, 사용자가 PDF를 언급할 때 Claude가 자동으로 활용
Command: 사용자가 /generate-report 입력했을 때만 실행

Agent Skills의 이점

특정 워크플로우를 위해 Claude의 기능 확장 - 반복되는 작업을 자동화
git을 통해 팀 전체에서 전문 지식 공유 - 변경사항이 자동으로 동기화
반복적인 프롬프팅 감소 - 매번 상세한 지침을 입력할 필요 없음
복잡한 작업을 위해 여러 Skills 구성 - 조직적인 작업 흐름 관리

더 자세한 내용은 Agent Skills 개요를 참고하세요.

Skill 생성

Skills는 SKILL.md 파일을 포함하는 디렉토리로 저장됩니다. 어떤 유형의 Skill을 선택할지는 범위와 대상 사용자에 따라 결정합니다.

1. Personal Skills (개인용)

저장 위치: ~/.claude/skills/skill-name/SKILL.md

개인용 Skills는 당신의 모든 프로젝트에서 사용 가능합니다.

mkdir -p ~/.claude/skills/my-personal-skill

Personal Skills 사용 대상:

개인 워크플로우 및 기본 설정
개발 중인 실험적 Skills (팀과 공유 전)
개인 생산성 도구 (예: 개인 코딩 스타일 가이드)

특징:

git에 저장되지 않음 (개인 컴퓨터에만 존재)
다른 프로젝트로 전환해도 자동으로 사용 가능
팀원들은 이 Skill을 사용할 수 없음

2. Project Skills (팀 공유)

저장 위치: .claude/skills/skill-name/SKILL.md

Project Skills는 프로젝트 저장소에 저장되어 팀 전체와 공유됩니다.

mkdir -p .claude/skills/my-team-skill

Project Skills 사용 대상:

팀 워크플로우 및 규칙 (예: 커밋 메시지 컨벤션)
프로젝트별 전문 지식 (예: API 문서 작성 규칙)
공유 유틸리티 및 스크립트

특징:

git에 체크인됨 (git add .claude/skills/)
팀 멤버가 git pull하면 자동으로 사용 가능
변경사항이 모두에게 자동 동기화

팀 공유 워크플로우:

# 1. Skill 폴더 생성
mkdir -p .claude/skills/commit-message-generator
 
# 2. SKILL.md 파일 작성 (다음 섹션 참고)
 
# 3. git에 추가 및 커밋
git add .claude/skills/
git commit -m "Add commit-message-generator Skill"
git push
 
# 4. 팀원들이 받으면 자동 사용 가능
git pull
# 이제 Skill을 사용할 수 있음!

3. Plugin Skills (배포용)

저장 위치: 플러그인 폴더의 skills/ 디렉토리

Skills는 Claude Code 플러그인으로도 배포할 수 있습니다.

Plugin Skills 사용 대상:

공개/상용 배포 (마켓플레이스)
조직 전체 공유 (조직 플러그인)
재사용 가능한 솔루션 패키지

특징:

플러그인 설치 시 자동으로 포함
Personal/Project Skills과 동일하게 동작
마켓플레이스에서 발견 가능

더 자세한 내용은 Claude Code - Plugin Skills 배포 문서를 참고하세요.

SKILL.md 작성

SKILL.md는 Skill의 정의와 지침을 담는 핵심 파일입니다. 필수 메타데이터와 상세한 지침으로 구성됩니다.

기본 구조

---
name: skill-name
description: Skill의 기능과 사용 시기를 설명
---
 
# Skill 이름
 
## 지침
구체적인 단계별 지침
 
## 예제
실제 사용 사례

필드 상세 설명

1. `name` (필수)

요구사항:

소문자만 사용
숫자와 하이픈(-) 허용
최대 64자
공백이나 특수문자 불가

좋은 예제:

commit-message-generator
pdf-text-extractor
weekly-report-writer

피해야 할 예제:

CommitMessageGenerator (대문자 사용)
commit message generator (공백 사용)
commit_message_generator (언더스코어 사용)

2. `description` (필수)

이것이 가장 중요한 필드입니다. Claude가 Skill을 사용할지 결정하는 기준입니다.

요구사항:

최대 1024자
2가지 정보 포함 필수:
1. Skill이 무엇을 하는가 (기능)
2. 언제 사용하는가 (트리거/사용 사례)

좋은 예제 (구체적):

Analyze Excel spreadsheets and create pivot tables, charts, and summaries.
Use when working with Excel files, spreadsheets, or analyzing tabular data
in .xlsx format. Can also handle CSV data conversion.

피해야 할 예제 (모호함):

Helps with data

더 자세한 가이드:

구체적인 파일 형식 언급: “PDF”, “Excel”, “.xlsx” 등
사용 시나리오 포함: “데이터 분석”, “보고서 작성”, “자동화” 등
사용자가 언급할 키워드: 사용자가 요청할 때 자주 말할 단어들

3. `allowed-tools` (선택사항)

Skill이 사용할 수 있는 도구를 제한합니다. 보안 및 제어가 중요한 경우 사용합니다.

---
name: safe-file-reader
description: Read files safely without making changes
allowed-tools: Read, Grep, Glob
---

common tools:

Read - 파일 읽기
Grep - 파일에서 검색
Glob - 파일 패턴 검색
Edit - 파일 수정
Write - 파일 생성
Bash - 터미널 명령 실행

사용 사례:

읽기만 가능한 Skill (도구 제한)
특정 파일만 수정 가능하게 제한
위험한 명령(삭제, 배포) 방지

지원 파일 추가

간단한 Skill은 SKILL.md만으로 충분하지만, 복잡한 Skill은 보조 파일을 추가할 수 있습니다.

파일 구조

my-skill/
├── SKILL.md              # 필수: 핵심 지침
├── REFERENCE.md          # 선택: API 상세 문서
├── EXAMPLES.md           # 선택: 실제 사용 예제
├── scripts/              # 선택: 자동화 스크립트
│   ├── process.py
│   └── validate.sh
└── templates/            # 선택: 템플릿 파일
    └── template.txt

파일 참조하기

SKILL.md에서 다른 파일을 링크할 수 있습니다:

# My Skill
 
기본 지침...
 
더 자세한 내용: [REFERENCE.md](REFERENCE.md)
실제 예제: [EXAMPLES.md](EXAMPLES.md)
 
스크립트 실행:
\`\`\`bash
python scripts/process.py input.txt
\`\`\`

점진적 공개 (Progressive Disclosure)

Claude는 필요할 때만 추가 파일을 읽습니다:

사용자가 기본 기능만 요청 → SKILL.md만 로드
사용자가 “자세히 알려줄래?” → REFERENCE.md 로드
특정 예제 요청 → EXAMPLES.md 로드

이점:

맥락 효율성 증가 (context efficiency)
더 큰 Skill도 빠른 응답
필요한 정보만 읽음

보조 파일 생성 팁

각 파일을 역할별로 명확하게 분리
중복 제거 (SKILL.md의 내용을 REFERENCE.md에서 반복하지 않기)
파일이 자동 실행되지 않음 - Claude가 명시적으로 참조할 때만 로드

더 복잡한 Skill 만드는 방법: Agent Skills - 고급 활용

사용 가능한 Skills 보기

Claude는 세 가지 소스에서 자동으로 Skills를 발견합니다:

소스별 저장 위치

소스	위치	범위	git 추적
Personal	`~/.claude/skills/`	모든 프로젝트	❌ 아니오
Project	`./.claude/skills/`	현재 프로젝트만	✅ 예
Plugin	(플러그인 설치 시)	플러그인 설정에 따름	변함

Skills 조회하기

방법 1: Claude에 직접 질문 (권장)

Claude Code에서 다음처럼 입력하면 모든 사용 가능한 Skills를 보여줍니다:

현재 사용 가능한 Skills가 뭐 있어?

또는

What Skills are available?

Claude가 다음을 자동으로 표시합니다:

✅ Personal Skills (당신의 개인용)
✅ Project Skills (팀 공유용)
✅ Plugin Skills (설치된 플러그인)

방법 2: 파일 시스템에서 확인

직접 파일을 확인할 수도 있습니다:

# Personal Skills 목록
ls ~/.claude/skills/
 
# 출력 예:
# commit-message-helper/
# pdf-processor/
# weekly-report-writer/
 
# 특정 Skill의 내용 확인
cat ~/.claude/skills/commit-message-helper/SKILL.md
 
# 프로젝트 Skills 확인 (프로젝트 디렉토리 내에서)
ls .claude/skills/

Skills 정보 확인

특정 Skill의 상세 정보를 보려면:

# Personal Skill의 메타데이터 확인
head -n 10 ~/.claude/skills/my-skill/SKILL.md
 
# 모든 파일 구조 확인
tree ~/.claude/skills/my-skill/
# 또는
find ~/.claude/skills/my-skill/ -type f

여러 Skill 찾기

특정 패턴의 Skill을 찾으려면:

# "pdf"라는 단어가 포함된 Personal Skills
ls ~/.claude/skills/ | grep pdf
 
# 모든 SKILL.md 파일 찾기
find ~/.claude/skills -name "SKILL.md"

Skill 테스트하기

Skill을 만들었다면 자동으로 작동하는지 검증해야 합니다.

테스트 절차

1단계: Skill 생성 확인

# 파일이 올바른 위치에 있는가?
ls ~/.claude/skills/my-skill/SKILL.md
# 또는
ls .claude/skills/my-skill/SKILL.md

2단계: Claude에 요청하기

Skill의 description과 일치하는 질문을 하세요.

설명 예:

description: Extract text from PDF files, fill forms, merge documents.
Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.

테스트 질문:

이 PDF에서 텍스트를 추출해줄 수 있어?

또는

두 개의 PDF를 병합해야 하는데 도와줄래?

3단계: 결과 확인

Claude가 자동으로 Skill을 사용하면 성공입니다!

✅ 좋은 신호:
- Claude가 "PDF 프로세서 Skill을 사용하겠습니다"라고 언급
- Skill의 지침에 따라 작업 수행
- SKILL.md의 내용을 기반으로 응답

❌ 문제 신호:
- Skill을 사용하지 않고 일반적인 답변만 함
- "PDF 처리 방법을 일반적으로 설명"함

테스트 팁

팁 1: Description이 충분히 구체적인가?

❌ 나쁜 설명 (인지되지 않음):

description: Helps with documents

✅ 좋은 설명 (잘 인지됨):

description: Extract text, tables from PDF files, merge multiple PDFs into one document,
fill PDF forms. Use when working with PDF files, extracting content, combining documents,
or completing PDF forms.

팁 2: 여러 번 테스트하기

다양한 상황에서 테스트:

테스트 1: 기본 사용
"PDF에서 텍스트를 추출해줄래?"

테스트 2: 부가 기능
"두 PDF를 합쳐줄래?"

테스트 3: 상세 요청
"이 인보이스 PDF에서 금액을 추출하고 분석해줄래?"

팁 3: Claude Code 재시작

Skill 파일을 수정한 후에는 Claude Code를 재시작하세요:

# 1. Claude Code 종료
# 2. 재시작
claude
 
# Skill이 다시 로드됨

테스트 체크리스트

Skill을 배포하기 전 확인할 사항:

[ ] SKILL.md이 올바른 위치에 있는가?
[ ] YAML 문법이 정확한가? (--- 로 시작/종료)
[ ] name이 소문자와 하이픈만 포함하는가?
[ ] description이 구체적인가? (기능 + 사용 시기)
[ ] 기본 테스트 질문에 반응하는가?
[ ] 여러 시나리오에서 테스트했는가?
[ ] 지침이 명확하고 따라하기 쉬운가?
[ ] 예제가 실제로 동작하는가?
[ ] 팀원들이 테스트했는가? (프로젝트 Skill인 경우)

Skill 디버깅

Skill이 자동으로 작동하지 않으면 차근차근 확인하세요.

❌ 문제 1: Skill이 로드되지 않음

증상: Skill 폴더를 만들었는데 Claude가 인식하지 못함

확인 1: 파일 위치

올바른 위치에 SKILL.md가 있는가?

# Personal Skill
ls ~/.claude/skills/my-skill/SKILL.md
 
# Project Skill (프로젝트 디렉토리에서)
ls .claude/skills/my-skill/SKILL.md

확인 2: YAML 문법

YAML 문법 오류가 가장 흔한 원인입니다.

cat ~/.claude/skills/my-skill/SKILL.md | head -n 15

필수 확인:

✅ 첫 줄: --- (정확히)
✅ name/description 있음
✅ 종료: --- (마크다운 본문 전)
✅ 들여쓰기: 공백만 사용 (탭 금지!)
✅ 콜론(:) 뒤에 공백

나쁜 예:

---
name:my-skill             # ❌ 콜론 뒤에 공백 없음
description: Test
	extra: line           # ❌ 탭 사용
---

좋은 예:

---
name: my-skill
description: Test
extra: value
---

해결책 1: Claude Code 재시작

파일을 만든 후 Claude Code를 재시작하세요:

# 종료 후 재시작
claude

해결책 2: YAML 온라인 검증

YAML 유효성 검사:

웹사이트: https://www.yamllint.com/
파일 전체를 복사해서 붙여넣고 검증

❌ 문제 2: Skill이 로드되지만 자동으로 작동하지 않음

증상: ls .claude/skills/ 해보니 폴더가 있는데, Claude가 사용하지 않음

원인: Description이 모호함

Claude는 description을 읽고 필요할지 판단합니다.

❌ 인식되지 않는 설명:

description: Helps with data

✅ 잘 인식되는 설명:

description: Analyze Excel spreadsheets, create pivot tables, and generate charts.
Use when working with Excel files, .xlsx files, or analyzing tabular data.

해결책: Description 개선

필수 포함사항:

구체적인 파일 형식: “PDF”, “Excel”, “.xlsx”, “.csv”
사용 시기: “데이터 분석”, “보고서”, “자동화”
사용자가 말할 키워드: 사용자가 실제로 입력할 단어들

개선 전/후:

# ❌ 나쁨
description: Process files
 
# ✅ 좋음
description: Extract text and tables from PDF files, merge multiple PDFs,
fill PDF forms. Use when working with PDF files, extracting content,
combining documents, or completing forms.

❌ 문제 3: 파일 권한 오류

증상: 스크립트가 포함된 Skill인데 “권한 없음” 오류

해결책

# 스크립트 실행 권한 추가
chmod +x .claude/skills/my-skill/scripts/process.py
chmod +x .claude/skills/my-skill/scripts/run.sh
 
# 확인
ls -la .claude/skills/my-skill/scripts/
# 실행 권한이 있으면: -rwxr-xr-x

❌ 문제 4: 여러 비슷한 Skills가 혼동됨

증상: 여러 개의 데이터 분석 Skill이 있는데 Claude가 헷갈림

원인: Description이 너무 비슷함

# Skill 1
description: Analyze data
 
# Skill 2
description: Analyze data

해결책: 각 Skill을 고유하게

# Skill 1
description: Analyze sales data in Excel files, create revenue charts,
and generate sales reports. Use for sales analysis and reporting.
 
# Skill 2
description: Analyze server log files and performance metrics data.
Use for system monitoring, performance analysis, and debugging.

🔍 디버그 팁

팁 1: 간단한 질문으로 테스트

모호한 요청보다 구체적인 요청으로 테스트:

❌ "뭔가 해줄 수 있어?"

✅ "이 PDF에서 텍스트를 추출해주겠어?"

팁 2: 다른 Skill 비활성화해서 테스트

여러 Skills이 비슷하면 하나씩 비활성화해서 테스트:

# 테스트용 임시 폴더로 옮기기
mv ~/.claude/skills/other-skill ~/.claude/skills/.disabled_other-skill
 
# Claude Code 재시작 후 테스트
 
# 복구
mv ~/.claude/skills/.disabled_other-skill ~/.claude/skills/other-skill

팁 3: Claude에게 직접 물어보기

현재 사용 가능한 Skills를 모두 보여줄 수 있어?

Claude가 로드된 모든 Skills를 나열합니다.

팀과 Skills 공유

Skill을 개인용으로만 사용하거나, 팀 전체가 함께 사용하도록 공유할 수 있습니다.

공유 방법 비교

방법	설정	범위	버전 관리
Personal	간단	개인만	❌
Project (git)	보통	팀	✅ git
Plugin	복잡	조직/공개	✅ 버전 관리

방법 1: Project Skill로 공유 (권장)

팀 프로젝트 저장소를 사용하는 경우 Project Skills를 사용하세요.

단계 1: 프로젝트에 Skill 추가

mkdir -p .claude/skills/my-team-skill
touch .claude/skills/my-team-skill/SKILL.md

단계 2: SKILL.md 작성

---
name: my-team-skill
description: 팀이 사용할 Skill 설명
---
 
# My Team Skill
 
지침...

단계 3: Git에 커밋

git add .claude/skills/
git commit -m "Add my-team-skill"
git push

단계 4: 팀원들이 사용

팀원들이 git pull하면 자동으로 사용 가능:

git pull
# 이제 Skill이 자동으로 인식됨!

방법 2: Plugin으로 배포 (공개/조직)

여러 프로젝트나 조직 전체가 사용할 Skill인 경우 Plugin으로 배포하세요.

완전한 지침: Claude Code - Plugin Skills 배포

팀 Skill 모범 사례

1. 명확한 문서화

다른 팀원도 이해할 수 있도록:

---
name: team-git-workflow
description: Generate conventional commit messages following our team standards.
Use when writing commit messages, and ensure messages follow our format.
---
 
# Team Git Workflow Skill
 
**팀 규칙**:
- Conventional Commit 형식 필수
- 영어로 작성
- 한 번에 하나의 기능만 커밋
 
## 예제
 
(팀 프로젝트별 예제)

2. 버전 관리

SKILL.md에 버전 정보 추가:

# My Team Skill
 
**현재 버전**: v2.0.0 (2025-11-28)
 
## 변경 이력
 
- v2.0.0: 새로운 형식 추가
- v1.5.0: 버그 수정
- v1.0.0: 초기 릴리스

3. 주기적 검토

# 매 분기마다 팀이 함께 Skill 검토
# - 여전히 필요한가?
# - 지침이 여전히 유효한가?
# - 개선할 점이 있는가?

Skill 업데이트

SKILL.md를 직접 편집하세요:

# Personal Skill
code ~/.claude/skills/my-skill/SKILL.md

# Project Skill
code .claude/skills/my-skill/SKILL.md

변경사항은 다음에 Claude Code를 시작할 때 적용됩니다. Claude Code가 이미 실행 중이면 업데이트를 로드하려면 다시 시작하세요.

Skill 제거

Skill 디렉토리를 삭제하세요:

# Personal
rm -rf ~/.claude/skills/my-skill

# Project
rm -rf .claude/skills/my-skill
git commit -m "Remove unused Skill"

Skill 업데이트와 제거

Skill 업데이트하기

SKILL.md를 수정하면 Claude Code를 재시작할 때 변경사항이 반영됩니다.

# Personal Skill 편집
code ~/.claude/skills/my-skill/SKILL.md
 
# Project Skill 편집
code .claude/skills/my-skill/SKILL.md
 
# 저장 후 Claude Code 재시작
claude

Skill 제거하기

더 이상 사용하지 않는 Skill을 삭제하세요:

# Personal
rm -rf ~/.claude/skills/my-skill
 
# Project (git으로 추적)
rm -rf .claude/skills/my-skill
git add .claude/skills/
git commit -m "Remove deprecated my-skill"
git push

모범 사례

1. 단일 책임 원칙

하나의 Skill은 한 가지 기능만 담당해야 합니다.

✅ 좋은 예 (명확한 책임):

commit-message-helper - 커밋 메시지만
pdf-text-extractor - PDF 텍스트 추출만
excel-pivot-table-generator - 피벗 테이블만

❌ 나쁜 예 (책임 과다):

document-processor - PDF, Word, 이미지 모두 처리
data-tools - 분석, 시각화, 변환 모두

개선 방법: 큰 Skill을 여러 개의 작은 Skill로 분할

2. 명확하고 구체적인 Description

Description은 Claude가 Skill을 언제 사용할지 판단하는 기준입니다.

❌ 피해야 할 설명:

description: Helps with work
description: Data management tool
description: Useful for documents

✅ 좋은 설명:

description: Extract text and tables from PDF files, merge multiple PDFs into one document,
fill PDF forms. Use when working with PDF files, extracting content, combining documents,
or completing PDF forms. Works with password-protected PDFs.

Description 작성 팁:

동사로 시작 (Extract, Generate, Analyze)
구체적인 파일 형식 (PDF, Excel, .xlsx)
“Use when…” 절로 사용 시기 명시
대상 키워드 포함 (사용자가 말할 단어들)

3. 실제 예제 포함

지침만으로는 부족합니다. 실제 예제를 포함하세요:

## 예제
 
### 예제 1: 기본 사용
입력: ...
출력: ...
 
### 예제 2: 고급 사용
입력: ...
출력: ...

4. 팀과 함께 테스트

Project Skill을 배포하기 전:

팀원 1명이 실제로 사용해봤나?
Skill이 자동으로 활성화되나?
지침이 따라하기 쉬운가?
예제가 실제로 동작하는가?
예상 외의 상황은 없나?

5. 버전 관리

Skill이 변경되면 버전을 기록하세요:

## 버전 이력
 
- **v2.1.0** (2025-11-28): PDF 암호 지원 추가
- **v2.0.0** (2025-11-01): 새로운 커밋 형식 지원 (Breaking)
- **v1.0.0** (2025-10-01): 초기 릴리스

6. 문서 유지

시간이 지나면서 Skill을 개선하세요:

정기적으로 (분기별) 팀과 함께 검토
사용하지 않는 부분은 제거
새로운 기능은 추가
예제는 최신으로 유지

예제

간단한 Skill (단일 파일)

commit-helper/
└── SKILL.md

---
name: generating-commit-messages
description: Generates clear commit messages from git diffs. Use when writing commit messages or reviewing staged changes.
---

# Generating Commit Messages

## Instructions

1. Run `git diff --staged` to see changes
2. I'll suggest a commit message with:
   - Summary under 50 characters
   - Detailed description
   - Affected components

## Best practices

- Use present tense
- Explain what and why, not how

도구 권한이 있는 Skill

code-reviewer/
└── SKILL.md

---
name: code-reviewer
description: Review code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
allowed-tools: Read, Grep, Glob
---

# Code Reviewer

## Review checklist

1. Code organization and structure
2. Error handling
3. Performance considerations
4. Security concerns
5. Test coverage

## Instructions

1. Read the target files using Read tool
2. Search for patterns using Grep
3. Find related files using Glob
4. Provide detailed feedback on code quality

다중 파일 Skill

pdf-processing/
├── SKILL.md
├── FORMS.md
├── REFERENCE.md
└── scripts/
    ├── fill_form.py
    └── validate.py

SKILL.md:

---
name: pdf-processing
description: Extract text, fill forms, merge PDFs. Use when working with PDF files, forms, or document extraction. Requires pypdf and pdfplumber packages.
---

# PDF Processing

## Quick start

Extract text:
```python
import pdfplumber
with pdfplumber.open("doc.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For form filling, see [FORMS.md](FORMS.md).
For detailed API reference, see [REFERENCE.md](REFERENCE.md).

## Requirements

Packages must be installed in your environment:
```bash
pip install pypdf pdfplumber
```

Claude는 필요할 때만 추가 파일을 로드합니다.

다음 단계

초보자라면

Agent Skills - 시작하기를 읽으면서 첫 번째 Skill을 5분 안에 만들기
커밋 메시지, 코드 리뷰, 데이터 분석 등 자신의 작업과 관련된 Skill 만들기
팀원에게 공유하고 피드백 받기

더 복잡한 Skill을 만들려면

Agent Skills - 고급 활용에서 스크립트, 템플릿, 보조 파일을 포함한 Skill 만드는 방법 학습
실제 PDF 처리, 데이터 분석, Git 워크플로우 예제 따라하기
팀 규칙을 자동화하는 Skill 설계

자주 하는 질문

Q: Skill과 Command의 차이는?

Skill: 자동으로 활성화 (Claude가 필요를 감지)
Command: 사용자가 명시적으로 호출 (/command)

더 알아보기: Claude Code - Slash Commands

Q: Personal vs Project Skill은 언제 사용하나?

Personal: 개인 도구, 개인 프로젝트 전체에서 사용
Project: 팀 규칙, 팀 프로젝트 공유

Q: Skill이 자동으로 작동하지 않으면?

Skill 디버깅 섹션 확인
가장 흔한 원인: Description이 모호하거나 YAML 문법 오류

요약

Agent Skills는:

✅ Claude의 기능을 확장하는 모듈식 기능
✅ 자동으로 필요한 시점에 활성화
✅ 개인용 또는 팀 전체가 공유 가능
✅ git으로 버전 관리 가능
✅ 스크립트와 자동화 포함 가능

잘 만든 Skill의 특징:

단일 책임 (한 가지 기능만)
구체적인 Description
명확한 예제
실제 필요성 검증

자세한 내용은 공식 문서를 참고하세요: Claude Code - Agent Skills

Jeongsk

탐색기