Agent Skills

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

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

---
name: Your Skill Name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
Provide clear, step-by-step guidance for Claude.

## Examples
Show concrete examples of using this Skill.

my-skill/
├── SKILL.md (필수)
├── reference.md (선택적 문서)
├── examples.md (선택적 예제)
├── scripts/
│   └── helper.py (선택적 유틸리티)
└── templates/
    └── template.txt (선택적 템플릿)

고급 사용법은 [reference.md](reference.md)를 참조하세요.

도우미 스크립트 실행:
```bash
python scripts/helper.py input.txt
```

---
name: Safe File Reader
description: Read files without making changes. Use when you need read-only file access.
allowed-tools: Read, Grep, Glob
---

# Safe File Reader

This Skill provides read-only file access.

## Instructions
1. Use Read to view file contents
2. Use Grep to search within files
3. Use Glob to find files by pattern

What Skills are available?

List all available Skills

# 개인 Skills 목록
ls ~/.claude/skills/

# 프로젝트 Skills 목록 (프로젝트 디렉터리에 있는 경우)
ls .claude/skills/

# 특정 Skill의 내용 보기
cat ~/.claude/skills/my-skill/SKILL.md

Can you help me extract text from this PDF?

description: Helps with documents

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

# 개인
ls ~/.claude/skills/my-skill/SKILL.md

# 프로젝트
ls .claude/skills/my-skill/SKILL.md

cat SKILL.md | head -n 10

claude --debug

mkdir -p .claude/skills/team-skill
# SKILL.md 생성

git add .claude/skills/
git commit -m "Add team Skill for PDF processing"
git push

git pull
claude  # Skills를 이제 사용할 수 있습니다

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

# 프로젝트 Skill
code .claude/skills/my-skill/SKILL.md

# 개인
rm -rf ~/.claude/skills/my-skill

# 프로젝트
rm -rf .claude/skills/my-skill
git commit -m "Remove unused Skill"

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

description: For files

# My Skill

## Version History
- v2.0.0 (2025-10-01): Breaking changes to API
- v1.1.0 (2025-09-15): Added new features
- v1.0.0 (2025-09-01): Initial release

description: Helps with data

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

# frontmatter 보기
cat .claude/skills/my-skill/SKILL.md | head -n 15

# 일반적인 문제 확인
# - 여는 또는 닫는 --- 누락
# - 공백 대신 탭
# - 특수 문자가 있는 따옴표 없는 문자열

# 개인 Skills
ls ~/.claude/skills/*/SKILL.md

# 프로젝트 Skills
ls .claude/skills/*/SKILL.md

chmod +x .claude/skills/my-skill/scripts/*.py

# Skill 1
description: For data analysis

# Skill 2
description: For analyzing data

# Skill 1
description: Analyze sales data in Excel files and CRM exports. Use for sales reports, pipeline analysis, and revenue tracking.

# Skill 2
description: Analyze log files and system metrics data. Use for performance monitoring, debugging, and system diagnostics.

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

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

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

---
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
```