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

# Personal Skillsをリスト
ls ~/.claude/skills/

# Project 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.

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

# Project
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が利用可能になりました

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

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

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

# Project
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

# 一般的な問題をチェック
# - 開始または終了の---が不足
# - スペースの代わりにタブ
# - 特殊文字を含む引用符なしの文字列

# Personal Skills
ls ~/.claude/skills/*/SKILL.md

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