스킬 검색
Claude Code 스킬 허브에는 다양한 커뮤니티 스킬이 등록되어 있습니다. 필요한 기능을 제공하는 스킬을 찾아 즉시 설치하고 사용할 수 있습니다. 스킬 검색 명령어를 통해 키워드, 카테고리, 인기도 등으로 스킬을 찾아보세요.
스킬 검색 명령어
bash
# 모든 스킬 목록 보기
claude skill list
# 키워드로 검색
claude skill search "pdf"
claude skill search "testing"
claude skill search "documentation"
# 카테고리별 검색
claude skill search --category "development"
claude skill search --category "productivity"
# 인기 스킬 보기
claude skill list --popular
# 설치된 스킬 확인
claude skill list --installed검색 결과 예시
text
$ claude skill search "pdf"
📦 Available Skills:
1. pdf-tools (v1.2.0) ⭐ 4.8/5.0
Extract, merge, and manipulate PDF files
Downloads: 12.5k | Updated: 2 days ago
2. pdf-generator (v2.1.3) ⭐ 4.5/5.0
Generate PDFs from HTML/Markdown
Downloads: 8.2k | Updated: 1 week ago
3. pdf-ocr (v1.0.5) ⭐ 4.3/5.0
Extract text from scanned PDFs
Downloads: 3.1k | Updated: 3 weeks ago
Use 'claude skill install <name>' to install스킬 상세 정보
text
$ claude skill info pdf-tools
📦 pdf-tools (v1.2.0)
Description:
Comprehensive PDF manipulation toolkit
Features:
• Extract text and images
• Merge multiple PDFs
• Split PDF pages
• Add watermarks
• Convert to/from images
Author: @johndoe
License: MIT
Repository: github.com/skills/pdf-tools
Downloads: 12,543
Rating: ⭐ 4.8/5.0 (234 reviews)
Install: claude skill install pdf-tools- 🔍키워드 검색 - 이름, 설명, 태그로 스킬 찾기
- 📂카테고리 필터 - 개발, 생산성, 유틸리티 등으로 분류
- ⭐인기도 정렬 - 다운로드 수와 평점으로 정렬
- 📊상세 정보 - 기능, 작성자, 버전, 리뷰 확인
- 🔄업데이트 정보 - 최근 업데이트와 변경 사항
추천 스킬 발견하기: `claude skill list --popular`로 커뮤니티에서 가장 많이 사용하는 검증된 스킬을 확인할 수 있습니다. 다운로드 수와 평점이 높은 스킬부터 시작하는 것이 좋습니다.
스킬 설치
필요한 스킬을 찾았다면 간단한 명령어 하나로 설치할 수 있습니다. 스킬은 자동으로 다운로드되고 설정되며, 즉시 사용할 수 있습니다. Claude Code는 의존성 관리, 버전 호환성 검사, 자동 설정까지 모두 처리합니다.
기본 설치
bash
# 스킬 설치
claude skill install pdf-tools
# 출력:
📦 Installing pdf-tools...
✓ Downloaded pdf-tools@1.2.0
✓ Installed dependencies
✓ Configured skill
✓ pdf-tools is ready to use!
# 특정 버전 설치
claude skill install pdf-tools@1.1.0
# 여러 스킬 한 번에 설치
claude skill install pdf-tools testing-utils docs-generatorGit 저장소에서 설치
bash
# GitHub 저장소에서 설치
claude skill install github:username/skill-name
# GitLab 저장소
claude skill install gitlab:username/skill-name
# 특정 브랜치/태그
claude skill install github:username/skill#develop
claude skill install github:username/skill#v2.0.0
# 로컬 경로에서 설치 (개발용)
claude skill install ./my-custom-skill설치 옵션
bash
# 전역 설치 (모든 프로젝트에서 사용)
claude skill install pdf-tools --global
# 프로젝트별 설치 (현재 프로젝트만)
claude skill install pdf-tools --local
# 의존성 자동 설치 건너뛰기
claude skill install pdf-tools --no-deps
# 설치 후 자동 활성화 안 함
claude skill install pdf-tools --no-activate설치 후 확인
bash
# 설치된 스킬 목록
$ claude skill list --installed
Installed Skills:
pdf-tools@1.2.0 (global)
testing-utils@2.0.1 (local)
docs-generator@1.5.3 (global)
# 스킬 사용하기
$ claude
> /pdf extract document.pdf
# 스킬 명령어 도움말
$ claude skill help pdf-tools
Available commands:
/pdf extract <file> - Extract text from PDF
/pdf merge <files...> - Merge multiple PDFs
/pdf split <file> - Split PDF into pages- 📦자동 다운로드 - 스킬과 모든 의존성 자동 설치
- 🔍버전 관리 - 특정 버전 선택 및 호환성 검사
- 🌐다양한 소스 - 공식 허브, GitHub, 로컬 경로 지원
- ⚙️자동 설정 - 설치 즉시 사용 가능한 상태로 구성
- 🔄업데이트 알림 - 새 버전 출시 시 자동 안내
권한 확인: 스킬은 파일 시스템, 네트워크, 외부 도구 등에 접근할 수 있습니다. 신뢰할 수 있는 출처의 스킬만 설치하고, 설치 전 README와 권한 요구사항을 확인하세요.
프로젝트별 vs 전역: 팀 프로젝트에서는 `--local`로 설치하여 팀원 모두 같은 스킬 버전을 사용하도록 하세요. 개인 생산성 도구는 `--global`로 설치하여 모든 프로젝트에서 활용할 수 있습니다.
스킬 설정
대부분의 스킬은 설치 후 즉시 사용할 수 있지만, 일부 스킬은 API 키, 환경 변수, 옵션 등의 설정이 필요합니다. 스킬 설정 파일을 통해 개인화된 환경을 구성하고, 팀과 설정을 공유할 수 있습니다.
스킬 설정 파일
json
# 스킬 설정 파일 위치
~/.claude/skills/skill-name/config.json # 전역 설정
./claude-skills/skill-name/config.json # 프로젝트별 설정
# 설정 파일 예시 (pdf-tools)
{
"apiKey": "your-api-key-here",
"defaultOptions": {
"quality": "high",
"compression": true,
"outputFormat": "pdf"
},
"limits": {
"maxFileSize": "50MB",
"maxPages": 100
}
}대화형 설정
bash
# 설정 마법사 실행
$ claude skill configure pdf-tools
? Enter your API key: **********************
? Default output quality: (high/medium/low) high
? Enable compression? Yes
? Maximum file size: 50MB
✓ Configuration saved!
✓ pdf-tools is ready to use
# 특정 설정 값 변경
$ claude skill config pdf-tools set quality medium
$ claude skill config pdf-tools set maxFileSize 100MB
# 현재 설정 확인
$ claude skill config pdf-tools show환경 변수 사용
bash
# .env 파일 또는 환경 변수
PDF_TOOLS_API_KEY=your-api-key
PDF_TOOLS_QUALITY=high
PDF_TOOLS_MAX_SIZE=50MB
# 스킬이 자동으로 환경 변수 읽기
# config.json에 명시적 값이 없으면 환경 변수 사용
# 민감한 정보는 환경 변수로 관리
export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
# 프로젝트별 .env
echo "PDF_API_KEY=..." >> .env
echo ".env" >> .gitignore # 비밀 정보 보호팀 설정 공유
json
# .claude/skills/shared-config.json (Git에 커밋)
{
"pdf-tools": {
"quality": "high",
"compression": true
// API 키는 제외!
},
"testing-utils": {
"framework": "vitest",
"coverage": true
}
}
# 개인 설정 (Git 제외)
# .claude/skills/local-config.json
{
"pdf-tools": {
"apiKey": "personal-key-123" // 각자 설정
}
}
# .gitignore에 추가
.claude/skills/local-config.json
.claude/skills/*/secrets.json- ⚙️대화형 설정 - 마법사가 단계별로 안내
- 🔐보안 관리 - API 키와 민감 정보 안전하게 저장
- 👥팀 공유 - 공통 설정은 Git으로, 개인 설정은 로컬에
- 🌍환경 변수 - .env 파일과 시스템 환경 변수 지원
- 🔄설정 상속 - 전역 설정 + 프로젝트 설정 + 환경 변수 병합
보안 주의: API 키나 비밀번호는 절대 Git에 커밋하지 마세요! 환경 변수나 로컬 설정 파일을 사용하고, .gitignore에 추가하세요.
스킬 업데이트
스킬 개발자들은 지속적으로 버그를 수정하고 새로운 기능을 추가합니다. 정기적으로 스킬을 업데이트하여 최신 기능과 보안 패치를 받으세요. Claude Code는 업데이트 가능한 스킬을 자동으로 알려주고 안전하게 업데이트합니다.
업데이트 확인 및 실행
bash
# 업데이트 가능한 스킬 확인
$ claude skill outdated
Outdated Skills:
pdf-tools 1.2.0 → 1.3.1 (minor update, bug fixes)
testing-utils 2.0.1 → 3.0.0 (major update, breaking changes)
docs-gen 1.5.3 → 1.5.4 (patch update, security fix)
# 모든 스킬 업데이트
$ claude skill update
# 특정 스킬만 업데이트
$ claude skill update pdf-tools
# 특정 버전으로 업데이트
$ claude skill update pdf-tools@1.3.0
# 모든 스킬을 최신 버전으로
$ claude skill update --all안전한 업데이트
bash
# 패치 버전만 업데이트 (1.2.0 → 1.2.1)
$ claude skill update --patch-only
# 마이너 버전까지 (1.2.0 → 1.3.0)
$ claude skill update --minor
# 메이저 업데이트 확인 (2.x → 3.x)
$ claude skill update testing-utils
⚠️ Warning: Major version update (breaking changes)
Review changelog: github.com/skill/CHANGELOG.md
Continue? (y/N)
# 업데이트 전 백업
$ claude skill backup pdf-tools
✓ Backup created: ~/.claude/backups/pdf-tools-1.2.0.zip자동 업데이트
bash
# 자동 업데이트 설정
$ claude config set autoUpdate true
# 업데이트 정책 설정
$ claude config set updatePolicy patch # 패치만
$ claude config set updatePolicy minor # 마이너까지
$ claude config set updatePolicy all # 모든 업데이트
# 주간 업데이트 체크
$ claude config set updateCheck weekly
# 특정 스킬 자동 업데이트 제외
$ claude skill pin testing-utils@2.0.1
✓ testing-utils@2.0.1 pinned (won't auto-update)업데이트 내역 및 롤백
bash
# 변경 사항 확인
$ claude skill changelog pdf-tools
v1.3.1 (2024-01-15)
• Fixed: PDF merge bug with large files
• Added: Support for PDF/A format
• Improved: 30% faster extraction
v1.3.0 (2024-01-10)
• Added: OCR support
• Breaking: Renamed 'extract' to 'extractText'
# 이전 버전으로 롤백
$ claude skill rollback pdf-tools
Installed versions:
1.3.1 (current)
1.2.0
1.1.5
? Select version to rollback: 1.2.0
✓ Rolled back to pdf-tools@1.2.0- 🔔자동 알림 - 새 버전 출시 시 알림
- 🛡️안전 업데이트 - 변경 사항 미리 확인
- 📦버전 고정 - 특정 버전 유지하기
- 🔙쉬운 롤백 - 문제 발생 시 이전 버전 복구
- 📝변경 로그 - 업데이트 내용 상세 확인
시맨틱 버저닝: 버전 번호(1.2.3)는 Major.Minor.Patch를 의미합니다. Patch(1.2.3→1.2.4)는 안전, Minor(1.2.0→1.3.0)는 대부분 안전, Major(1.x→2.x)는 주의가 필요합니다.
스킬 제거
더 이상 필요하지 않은 스킬은 제거하여 디스크 공간을 절약하고 관리를 간소화할 수 있습니다. Claude Code는 의존성 확인 후 안전하게 스킬을 제거하며, 필요하면 관련 설정과 캐시도 함께 삭제합니다.
기본 제거
bash
# 스킬 제거
$ claude skill remove pdf-tools
⚠️ Are you sure you want to remove pdf-tools@1.2.0? (y/N) y
✓ Removed pdf-tools
✓ Cleaned up dependencies
✓ Removed configuration
# 여러 스킬 한 번에 제거
$ claude skill remove pdf-tools testing-utils docs-gen
# 확인 없이 제거 (스크립트에서 사용)
$ claude skill remove pdf-tools --yes설정 및 캐시 관리
bash
# 스킬만 제거, 설정은 유지
$ claude skill remove pdf-tools --keep-config
# 설정과 캐시까지 모두 삭제
$ claude skill remove pdf-tools --purge
# 미사용 의존성 정리
$ claude skill prune
Found unused dependencies:
- python-pdf-lib (used by pdf-tools)
- image-converter (used by pdf-tools)
Remove? (y/N) y
✓ Cleaned up 45MB
# 전역/로컬 스킬 구분 제거
$ claude skill remove pdf-tools --global
$ claude skill remove testing-utils --local의존성 확인
bash
# 의존성 체크
$ claude skill remove pdf-tools
⚠️ Warning: Other skills depend on pdf-tools:
- document-processor
- file-converter
Options:
1. Remove pdf-tools and dependent skills
2. Keep pdf-tools
3. Show dependency tree
? What would you like to do? 3
pdf-tools@1.2.0
├─ used by document-processor@2.1.0
└─ used by file-converter@1.5.0
# 강제 제거 (의존성 무시)
$ claude skill remove pdf-tools --force제거 후 복구
bash
# 최근 제거한 스킬 목록
$ claude skill list --removed
Recently removed:
pdf-tools@1.2.0 (removed 2 days ago, 45MB)
old-skill@0.9.0 (removed 1 week ago, 12MB)
# 제거한 스킬 복구
$ claude skill restore pdf-tools
✓ Restored pdf-tools@1.2.0
✓ Restored configuration
# 완전 삭제 (복구 불가)
$ claude skill remove pdf-tools --permanent
⚠️ This action cannot be undone!
✓ Permanently deleted pdf-tools- 🗑️안전 제거 - 의존성 확인 후 제거
- 💾설정 보존 - 재설치 시 이전 설정 유지 가능
- 🔄복구 가능 - 실수로 삭제해도 복원
- 🧹자동 정리 - 미사용 의존성 자동 정리
- 📊공간 확인 - 제거할 때 절약되는 용량 표시
의존성 주의: 다른 스킬이 의존하는 스킬을 제거하면 해당 스킬들도 작동하지 않을 수 있습니다. 제거 전 의존성 트리를 확인하세요.
스킬 문제 해결
스킬 사용 중 문제가 발생할 수 있습니다. 설치 실패, 실행 오류, 호환성 문제 등 일반적인 문제들의 해결 방법을 알아보고, 문제를 빠르게 진단하는 도구를 활용하세요.
진단 도구
bash
# 스킬 상태 확인
$ claude skill doctor pdf-tools
Checking pdf-tools@1.2.0...
✓ Skill files intact
✓ Dependencies installed
✗ Configuration missing API key
⚠ Python version 3.8 (recommended: 3.10+)
Recommendations:
1. Add API key: claude skill configure pdf-tools
2. Update Python: brew upgrade python
# 전체 시스템 진단
$ claude doctor
System Health Check:
✓ Claude Code v2.1.0
✓ Node.js v20.10.0
✗ Git not configured
⚠ 3 skills need updates
# 상세 로그 확인
$ claude skill logs pdf-tools --tail 50문제 1: 설치 실패
증상:
text
Error: Failed to install pdf-tools
Network error: ECONNREFUSED해결:
bash
# 1. 네트워크 확인
$ ping github.com
# 2. 프록시 설정 (필요시)
$ claude config set proxy http://proxy:8080
# 3. 캐시 정리 후 재시도
$ claude cache clean
$ claude skill install pdf-tools
# 4. 수동 다운로드
$ claude skill install github:username/pdf-tools문제 2: 명령어가 작동하지 않음
증상:
text
> /pdf extract file.pdf
Error: Command '/pdf' not found해결:
bash
# 1. 스킬 활성화 확인
$ claude skill list --installed
pdf-tools@1.2.0 (inactive) ← 비활성화 상태
# 2. 스킬 활성화
$ claude skill enable pdf-tools
$ claude skill activate pdf-tools
# 3. 세션 재시작
$ exit
$ claude
# 4. 스킬 재설치
$ claude skill remove pdf-tools
$ claude skill install pdf-tools문제 3: 호환성 문제
증상:
text
Error: pdf-tools requires Python >=3.10
Current version: 3.8해결:
bash
# 1. 필수 요구사항 확인
$ claude skill info pdf-tools
Requirements:
- Python: >=3.10
- Node.js: >=18.0
- Git: >=2.30
# 2. 환경 업데이트
$ brew upgrade python # macOS
$ apt upgrade python3 # Linux
# 3. 호환 버전 설치
$ claude skill install pdf-tools@1.1.0 # 이전 버전
# 4. 가상 환경 사용
$ python3 -m venv venv
$ source venv/bin/activate
$ claude skill install pdf-tools- 🔍자동 진단 - doctor 명령으로 문제 자동 탐지
- 📋상세 로그 - 오류 추적을 위한 디버그 로그
- 🔧자동 수정 - 일반적인 문제 자동 해결
- 📚문서화 - 각 스킬의 트러블슈팅 가이드
- 💬커뮤니티 지원 - 이슈 트래커와 포럼
도움 받기: 해결되지 않는 문제는 스킬 저장소의 Issues에 보고하거나 `claude skill debug pdf-tools`로 디버그 정보를 수집하여 공유하세요.