skill-creator

Original source / Raw SKILL.md

---
name: skill-creator
description: .claude/skills/以下に新しいスキルを作成するためのガイドとテンプレートを提供します。スキルの目的、アクティベーション条件、チェックリスト、詳細なリファレンス、例、テンプレートの作成を支援します。
---

# Skill Creator（スキル作成支援）

## 目的
`.claude/skills/` ディレクトリに新しいスキルを作成する際のガイドとテンプレートを提供し、一貫性のある高品質なスキルを効率的に作成できるようにします。

## いつアクティベートするか
このスキルは以下の場合に自動的にアクティベートされます：
- ユーザーが「新しいスキルを作成」「スキルを追加」と言った時
- `.claude/skills/` ディレクトリに新しいスキルを追加する必要がある時
- 既存のスキルを改善・拡張する時

## スキル作成の基本構造

### 必須ファイル
```
.claude/skills/your-skill-name/
├── SKILL.md          # メインのスキル定義（必須）
├── reference.md      # 詳細なリファレンス（任意）
├── examples.md       # 具体的な例（任意）
└── templates/        # テンプレートファイル（任意）
```

### SKILL.mdの構成

```markdown
---
name: skill-name
description: 簡潔な説明（1-2文）。いつアクティベートするか、何をチェックするかを明記。
---

# Skill Title

## 目的
このスキルの目的を1-2段落で説明

## いつアクティベートするか
- 箇条書きで具体的な条件を列挙
- ファイルパスやキーワードを含める

## クイックチェックリスト
作業前/後に確認すべき項目：
- [ ] チェック項目1
- [ ] チェック項目2
- [ ] チェック項目3

## 詳細なガイドライン
### セクション1
内容

### セクション2
内容

## テンプレート
（templates/ディレクトリがある場合）

## リファレンス
（reference.mdがある場合）

## 例
（examples.mdがある場合）
```

## スキル作成ステップ

### ステップ1: スキルの目的を明確化
以下の質問に答える：
1. **何を支援するスキルか？** (例: テスト作成、アーキテクチャチェック、データベース移行)
2. **いつ使われるべきか？** (ファイルパス、キーワード、状況)
3. **主なチェックポイントは？** (品質基準、ベストプラクティス)

### ステップ2: ディレクトリ構造を作成
```bash
mkdir -p .claude/skills/your-skill-name/templates
```

### ステップ3: SKILL.mdを作成
1. フロントマター（name, description）を記述
2. 目的セクションを記述
3. アクティベーション条件を列挙
4. クイックチェックリストを作成
5. 詳細なガイドラインを記述

### ステップ4: 必要に応じて補助ファイルを作成
- **reference.md**: 詳細な技術リファレンス、ベストプラクティス集
- **examples.md**: 良い例・悪い例のコード比較
- **templates/**: 再利用可能なコードテンプレート

## ベストプラクティス

### ✅ DO（推奨）
- **簡潔で具体的な説明**: 開発者がすぐに理解できる表現
- **実用的なチェックリスト**: 実際の作業に即座に適用できる項目
- **コード例を豊富に**: 良い例と悪い例を対比させる
- **テンプレートを提供**: よく使うパターンをテンプレート化
- **参照リンクを含める**: 関連ドキュメントへのリンク
- **日本語で記述**: プロジェクトの言語ポリシーに従う

### ❌ DON'T（非推奨）
- **抽象的すぎる説明**: 具体的でないと使いにくい
- **長すぎる文章**: 要点を絞る
- **チェック不可能な項目**: 客観的に確認できる項目のみ
- **重複したコンテンツ**: 既存スキルと役割を明確に分ける

## チェックリスト

新しいスキルを作成する前に：
- [ ] **既存スキルと重複していないか確認**
- [ ] **スキル名がケバブケース（kebab-case）になっているか**
- [ ] **descriptionが簡潔で具体的か（50-150文字程度）**
- [ ] **アクティベーション条件が明確か**
- [ ] **チェックリストが実用的か**
- [ ] **コード例が含まれているか**
- [ ] **日本語で記述されているか**

スキル作成後に：
- [ ] **SKILL.mdのフロントマターが正しいか**
- [ ] **ファイル構造が統一されているか**
- [ ] **リンクが正しく機能するか**
- [ ] **実際に使ってみて有用か確認**

## テンプレート

このスキルの `templates/` ディレクトリに以下のテンプレートがあります：
- `SKILL_template.md`: 新しいスキルのSKILL.mdテンプレート
- `reference_template.md`: reference.mdのテンプレート
- `examples_template.md`: examples.mdのテンプレート

## リファレンス

詳細なガイドラインとテンプレートの使い方は [reference.md](reference.md) を参照してください。

## 例

既存のスキル例：
- `test-writer`: テスト作成ガイド（reference.md, examples.md, templates/あり）
- `clean-architecture-checker`: アーキテクチャチェック（reference.md, examples.md, templates/あり）
- `migration-helper`: データベース移行支援（reference.md, templates/あり）
- `sagebase-commands`: コマンドリファレンス（reference.mdあり）
- `bi-dashboard-commands`: BIダッシュボードコマンド（reference.mdあり）

具体的な例は [examples.md](examples.md) を参照してください。