Skill Management

スキル作成、更新、テスト、管理のための公式ガイドです。

Skill 保存場所

Skill 作成

1. ディレクトリ作成

# Personal Skill
mkdir -p ~/.claude/skills/my-skill-name

# Project Skill
mkdir -p .claude/skills/my-skill-name

2. SKILL.md 作成

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
allowed-tools: Read, Grep, Glob  # オプション
---

# Your Skill Name

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

## Examples
Show concrete examples of using this Skill.

Frontmatter ルール

Skill 構造

単一ファイル

my-skill/
└── SKILL.md

複数ファイル

my-skill/
├── SKILL.md (必須)
├── references/
│   └── REFERENCE.md (オプション)
├── scripts/
│   └── helper.py (オプション)
└── templates/
    └── template.txt (オプション)

参照リンク

詳細については [references/REFERENCE.md](references/REFERENCE.md) を参照してください。

スクリプト実行:
```bash
python scripts/helper.py input.txt

---

## allowed-tools

ツール使用を制限して安全なスキルを作成:

```yaml
---
name: safe-file-reader
description: Read files without making changes.
allowed-tools: Read, Grep, Glob
---

使用例:

• 読み取り専用スキル
• セキュリティに敏感なワークフロー
• 機能範囲の制限

Skill 管理

リスト確認

# Personal Skills
ls ~/.claude/skills/

# Project Skills
ls .claude/skills/

# 特定のスキル内容確認
cat ~/.claude/skills/my-skill/SKILL.md

更新

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

チーム共有

ステップ 1: プロジェクトに追加

mkdir -p .claude/skills/my-skill
# SKILL.md 作成

ステップ 2: Git コミット

git add .claude/skills/
git commit -m "feat(skills): add my-skill"
git push

ステップ 3: チームメンバー自動適用

チームメンバーが pull すると自動的にスキルが使用可能になります。

ベストプラクティス

1. 集中的な維持

✅ GOOD: "Git commit messages"
✅ GOOD: "PDF form filling"
❌ BAD: "Document processing" (分割が必要)

2. 明確な description

# ✅ GOOD
description: Analyze Excel spreadsheets and create pivot tables. 
             Use when working with .xlsx files or tabular data.

# ❌ BAD
description: For files

3. バージョン文書化

## Version History
- v2.0.0 (2025-10-01): Breaking changes
- v1.0.0 (2025-09-01): Initial release

4. 推奨行数

問題解決

Claude がスキルを使用しない

1. description がトリガーキーワードを含んでいるか確認してください。
2. ファイルパスを確認してください (SKILL.md の大文字小文字)。
3. YAML 構文エラーを確認してください。

スキルエラー発生

# YAML 構文検証
cat SKILL.md | head -10

複数のスキルが衝突

• description でトリガー条件を明確化してください。
• スキルの範囲を狭めてください。

例

簡単なスキル

---
name: commit-helper
description: Generates clear commit messages from git diffs.
---

# Commit Helper

1. Run `git diff --staged` to see changes
2. Suggest commit message with:
   - Summary under 50 characters
   - Detailed description

読み取り専用スキル

---
name: code-reviewer
description: Review code for best practices.
allowed-tools: Read, Grep, Glob
---

# Code Reviewer

## Review checklist
1. Code organization
2. Error handling
3. Security concerns

Checklist

スキル作成時:

• [ ] name: 小文字+数字+ハイフン、64文字以内
• [ ] description: 作業内容 + 使用時期
• [ ] 単一責任原則 (一つの役割)
• [ ] 例を含む
• [ ] 500行以内 (超過する場合は REFERENCE に分割)