skill-creator

スキル作成

Claude の機能を拡張するモジュール式のエージェントスキルを作成します。スキルは、手順、スクリプト、リソースを含む、見つけやすいフォルダーに専門知識をまとめます。

使用するタイミング

• 「〜のスキルを作成して」
• 「新しいスキルを作って」
• 「〜するスキルを追加して」
• 「スキルの作成方法を教えて」
• 「このワークフローをスキルとして文書化して」

---

クイックスタート：スキルを作成する

1. 保存場所を選ぶ

# Personal skill (all projects)
mkdir -p ~/.claude/skills/my-skill

# Project skill (shared via git)
mkdir -p .claude/skills/my-skill

2. SKILL.md を作成する

---
name: my-skill
description: Brief description of what it does and when to use it.
---

# My Skill

## Instructions
Step-by-step guidance for Claude.

## Examples
Concrete usage examples.

3. テストする

説明に合致する質問を Claude にします。スキルはコンテキストに基づいて自動的に有効になります。

---

SKILL.md の構成

必須：YAML フロントマター

---
name: lowercase-with-hyphens    # Max 64 chars, [a-z0-9-] only
description: What it does AND when to use it. Include trigger keywords.
---

重要：description フィールドによって、Claude がスキルを見つけて使用するタイミングが決まります。

任意：ツールの権限

---
name: safe-reader
description: Read-only file access. Use for code review without modifications.
allowed-tools: Read, Grep, Glob
---

allowed-tools が設定されている場合、Claude は許可を求めずにそのツールのみを使用できます。

コンテンツのセクション

# Skill Name

Brief overview.

## Prerequisites
Installation or setup if needed.

## CLI Reference
Commands with examples.

## Common Workflows
Step-by-step procedures.

## Best Practices
Guidelines and tips.

---

スキルの種類

種類	保存場所	適用範囲	共有
個人用	~/.claude/skills/	すべてのプロジェクト	いいえ
プロジェクト用	.claude/skills/	このリポジトリ	はい（git）
プラグイン	インストール済みプラグイン経由	プラグイン単位	マーケットプレイス経由

---

補助ファイル

SKILL.md と同じ場所にファイルを追加します。

my-skill/
├── SKILL.md           # Required
├── reference.md       # Optional docs
├── examples/          # Optional examples
├── scripts/           # Optional utilities
│   └── helper.ts
└── templates/         # Optional templates

SKILL.md から参照します。

See [reference.md](reference.md) for details.

Run the helper:
` ` `bash
bun scripts/helper.ts
` ` `

Claude は必要なときにのみ補助ファイルを読み込みます（段階的な情報開示）。

---

適切な説明の書き方

悪い例（曖昧すぎる）：

description: Helps with data

良い例（具体的なトリガー）：

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

次の内容を含めます。

• スキルが行うこと
• スキルを使用するタイミング
• ユーザーが口にする可能性のある主なトリガーワード

---

完全な例

~/.claude/skills/api-testing/SKILL.md を作成する

---
name: api-testing
description: Test REST APIs with curl and analyze responses. Use when testing endpoints, debugging APIs, or validating HTTP requests.
---

# API Testing

Test and debug REST APIs from the command line.

## Prerequisites

` ` `bash
# Verify curl is available
curl --version
` ` `

## CLI Reference

### Basic Requests
` ` `bash
curl -X GET "https://api.example.com/users"
curl -X POST "https://api.example.com/users" \
  -H "Content-Type: application/json" \
  -d '{"name": "John"}'
` ` `

### With Authentication
` ` `bash
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.example.com/protected"
` ` `

### Save Response
` ` `bash
curl -o response.json "https://api.example.com/data"
` ` `

## Common Workflows

### Test Endpoint Health
` ` `bash
# Check status code
curl -s -o /dev/null -w "%{http_code}" https://api.example.com/health

# Measure response time
curl -w "Time: %{time_total}s\n" -o /dev/null -s https://api.example.com
` ` `

## Best Practices

1. **Use -s for scripts** - Silent mode hides progress
2. **Use -f to fail** - Exit non-zero on HTTP errors
3. **Use jq for JSON** - Pipe to `jq` for pretty output

---

検証チェックリスト

完了と判断する前に、次の項目を確認します。

• SKILL.md に有効な YAML フロントマターがある
• 名前が小文字とハイフンで構成されている（最大 64 文字）
• 説明に内容と使用タイミングの両方が含まれている（最大 1024 文字）
• 手順が明確で、実行可能である
• CLI コマンドに説明コメントが付いている
• Claude がスキルを見つけて使用することを確認済みである

---

トラブルシューティング

Claude がスキルを使用しない

1. 説明が曖昧すぎる - 具体的なトリガーキーワードを追加します
2. 保存場所が違う - パスが規約と完全に一致しているか確認します
3. YAML が無効 - フロントマターの構文を検証します
4. 再起動が必要 - 変更後に Claude Code を再起動します

スキルの読み込みを確認する

# Verify file exists
cat ~/.claude/skills/my-skill/SKILL.md

# List all skills
ls ~/.claude/skills/*/SKILL.md
ls .claude/skills/*/SKILL.md

フロントマターをデバッグする

# View first 10 lines
head -n 10 ~/.claude/skills/my-skill/SKILL.md

次の点を確認します。

• 1 行目に開始の --- がある
• コンテンツの前に終了の --- がある
• タブを使っていない（スペースを使用）
• 特殊文字を含む文字列が引用符で囲まれている

---

既存のスキルを調べる

# See all personal skills
ls ~/.claude/skills/*/SKILL.md

# Good examples to study
cat ~/.claude/skills/beads/SKILL.md     # Task tracking CLI
cat ~/.claude/skills/gemini/SKILL.md    # AI research CLI
cat ~/.claude/skills/github/SKILL.md    # gh CLI patterns