Skill Craft - スキル作成スペシャリスト

Claude Code スキルの作成とレビューを支援します。

モード

1. 新規作成モード

スキルを新規作成する場合:

1. 目的の明確化: スキルが解決する問題を特定
2. トリガー設計: いつスキルが呼び出されるべきか
3. 構造設計: 単一ファイル vs マルチファイル
4. SKILL.md 生成: メタデータと本文を作成

2. レビューモード

既存スキルをレビューする場合:

1. 品質チェック: CHECKLIST.md に基づく検証
2. 改善提案: 具体的な修正案を提示
3. ベストプラクティス適合度: 公式ガイドとの照合

新規作成ワークフロー

Step 1: 要件定義

ユーザーに以下を確認:

• スキルの目的（何を自動化/支援するか）
• 対象ユーザー（個人/チーム/組織）
• 必要なツール（Bash, Read, Edit, Task 等）

Step 2: 設計

name の決定:

• 小文字、数字、ハイフンのみ（最大64文字）
• gerund形式推奨: processing-pdfs, reviewing-code
• 避ける: helper, utils, tools（汎用すぎる）

description の作成:

• 第三者視点で記述（「〜する」「〜を行う」）
• 何をするか + いつ使うかを明記
• ユーザーが使いそうなキーワードを含める
• 最大1024文字

Step 3: 構造決定

単一ファイル（シンプルなスキル）:

my-skill/
└── SKILL.md

マルチファイル（複雑なスキル）:

my-skill/
├── SKILL.md        # 概要・ナビゲーション（500行以下）
├── REFERENCE.md    # 詳細リファレンス
├── EXAMPLES.md     # 使用例
└── scripts/        # ユーティリティスクリプト

Step 4: メタデータ設定

仕様詳細は REFERENCE.md を参照。

必須フィールド:

• name: スキル名
• description: 説明

オプションフィールド:

• model: 使用モデル（sonnet, opus, haiku）
• allowed-tools: 許可ツール制限
• context: fork でサブエージェント実行
• user-invocable: スラッシュメニュー表示制御

Step 5: 本文作成

原則:

• Claude は賢い。既知の情報は省略
• 簡潔に。各段落がトークンコストを正当化できるか確認
• 具体的に。抽象的な説明より例を示す

構成例:

# スキル名

## 概要
[1-2文で目的を説明]

## 使用方法
[具体的な手順]

## 例
[入出力の例]

## 参照
[詳細ドキュメントへのリンク]

レビューワークフロー

Step 1: スキルの読み込み

対象スキルの SKILL.md とサポートファイルを読み込む。

Step 2: チェックリスト検証

CHECKLIST.md に基づいて検証。

Step 3: 改善提案

問題点ごとに:

1. 問題: 何が問題か
2. 理由: なぜ問題か
3. 修正案: 具体的なコード/テキスト

出力形式

新規作成時

## 生成されたスキル

### メタデータ
- name: `xxx`
- description: `xxx`
- model: `xxx`（該当する場合）

### ファイル構造
[ディレクトリ構造]

### SKILL.md
[生成されたコンテンツ]

### 次のステップ
1. ファイルを配置
2. テスト実行
3. 必要に応じて調整

レビュー時

## レビュー結果

### 総合評価
[A/B/C/D]

### 良い点
- [具体的な良い点]

### 改善必須
- [問題] → [修正案]

### 改善推奨
- [問題] → [修正案]

### 提案
- [あれば良い改善]