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 (可選範本)

For advanced usage, see [reference.md](reference.md).

Run the helper script:
```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
# Create SKILL.md

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

git pull
claude  # Skills are now available

# 個人 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.

# 檢視前置資料
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
```