Skill Creator
新しいスキルを対話形式で作成するメタスキル。ユーザーから要件をヒアリングし、Anthropic公式形式のスキルを自動生成する。
ワークフロー
1. 要件ヒアリング
ユーザーから以下の情報を対話形式で収集する:
- •スキル名: hyphen-case形式(例:
my-new-skill)、最大40文字 - •説明: スキルの目的と発動条件(description)
- •必要なツール: bash, python など
- •参照データの有無: 参照ドキュメントやデータファイルが必要か
2. スキル初期化
テンプレートからスキルディレクトリを生成:
bash
python skills/skill-creator/scripts/init_skill.py <skill-name> --path ./skills
生成されるディレクトリ構造:
code
skills/<skill-name>/
├── SKILL.md # メタデータ + 指示
├── scripts/
│ └── example.py # サンプルスクリプト
├── references/
│ └── api_reference.md # 参照ドキュメント
└── assets/
└── example_asset.txt # アセットファイル
3. SKILL.md編集
ヒアリング内容に基づいてSKILL.mdを編集する。
YAMLフロントマター形式:
yaml
--- name: skill-name description: | スキルの説明。何ができるか、いつ発動するかを記述。 Claudeがこの説明を見てスキルを使うかどうかを判断する。 allowed-tools: - bash - python metadata: author: your-name version: 1.0.0 ---
本文: Markdownでスキルの使用方法、手順、制約を記述。
4. 検証
スキル構造を検証:
bash
python skills/skill-creator/scripts/quick_validate.py ./skills/<skill-name>
検証項目:
- •SKILL.mdの存在
- •YAMLフロントマターの形式
- •name, descriptionの必須フィールド
- •命名規則(hyphen-case)
- •文字数制限(name: 64文字、description: 1024文字)
5. 完了報告
作成されたファイル一覧をユーザーに報告し、次のステップを案内する。
使用可能なスクリプト
| スクリプト | 用途 | 使用例 |
|---|---|---|
init_skill.py | スキルテンプレート生成 | python scripts/init_skill.py my-skill --path ./skills |
quick_validate.py | スキル構造検証 | python scripts/quick_validate.py ./skills/my-skill |
package_skill.py | .skillファイル作成 | python scripts/package_skill.py ./skills/my-skill |
命名規則
- •hyphen-case: 小文字とハイフンのみ(
a-z,0-9,-) - •最大40文字
- •ハイフンで始まらない・終わらない
- •連続ハイフン禁止
良い例: data-analyzer, pdf-processor, email-sender
悪い例: DataAnalyzer, data_analyzer, -invalid-, too--many
SKILL.md フォーマット詳細
フロントマター(YAML)
| フィールド | 必須 | 説明 |
|---|---|---|
name | ✅ | スキル名(hyphen-case、最大64文字) |
description | ✅ | スキルの説明と発動条件(最大1024文字) |
license | ❌ | ライセンス情報 |
allowed-tools | ❌ | 使用可能なツールのリスト |
metadata | ❌ | author, versionなどの追加情報 |
本文(Markdown)
- •スキルの詳細な使用方法
- •ワークフローの手順
- •使用可能なリソース(scripts, references)の説明
- •入力/出力の例
- •制約事項
パッケージング(オプション)
スキルを配布可能な.skillファイルにパッケージ化:
bash
python skills/skill-creator/scripts/package_skill.py ./skills/<skill-name> ./dist
生成される.skillファイルはZIP形式で、他の環境にインポート可能。
制約
- •スキル名は一意である必要がある
- •既存スキルと同名の場合はエラー(上書きは確認後のみ)
- •SKILL.mdの本文は500行以下を推奨
- •大量の参照データはreferences/に分割する