skill-creator

Skill Creator（スキル作成支援）

目的

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

いつアクティベートするか

このスキルは以下の場合に自動的にアクティベートされます：

• ユーザーが「新しいスキルを作成」「スキルを追加」と言った時
• .claude/skills/ ディレクトリに新しいスキルを追加する必要がある時
• 既存のスキルを改善・拡張する時

スキル作成の基本構造

必須ファイル

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

SKILL.mdの構成

---
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: ディレクトリ構造を作成

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 を参照してください。

例

既存のスキル例：

• 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 を参照してください。