Skill Creator
新しいスキルを対話形式で作成するメタスキル。ユーザーから要件をヒアリングし、Anthropic公式形式のスキルを自動生成する。
ワークフロー
1. 要件ヒアリング
ユーザーから以下の情報を対話形式で収集する:
- スキル名: hyphen-case形式(例:
my-new-skill)、最大40文字 - 説明: スキルの目的と発動条件(description)
- 必要なツール: bash, python など
- 参照データの有無: 参照ドキュメントやデータファイルが必要か
2. スキル初期化
テンプレートからスキルディレクトリを生成:
python skills/skill-creator/scripts/init_skill.py <skill-name> --path ./skills
生成されるディレクトリ構造:
skills/<skill-name>/
├── SKILL.md # メタデータ + 指示
├── scripts/
│ └── example.py # サンプルスクリプト
├── references/
│ └── api_reference.md # 参照ドキュメント
└── assets/
└── example_asset.txt # アセットファイル
3. SKILL.md編集
ヒアリング内容に基づいてSKILL.mdを編集する。
YAMLフロントマター形式:
---
name: skill-name
description: |
スキルの説明。何ができるか、いつ発動するかを記述。
Claudeがこの説明を見てスキルを使うかどうかを判断する。
allowed-tools:
- bash
- python
metadata:
author: your-name
version: 1.0.0
---
本文: Markdownでスキルの使用方法、手順、制約を記述。
4. 検証
スキル構造を検証:
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ファイルにパッケージ化:
python skills/skill-creator/scripts/package_skill.py ./skills/<skill-name> ./dist
生成される.skillファイルはZIP形式で、他の環境にインポート可能。
制約
- スキル名は一意である必要がある
- 既存スキルと同名の場合はエラー(上書きは確認後のみ)
- SKILL.mdの本文は500行以下を推奨
- 大量の参照データはreferences/に分割する