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.

# 查看前置元数据
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
```