Skill Creator

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. 完了報告

作成されたファイル一覧をユーザーに報告し、次のステップを案内する。

使用可能なスクリプト

命名規則

• hyphen-case: 小文字とハイフンのみ（a-z, 0-9, -）
• 最大40文字
• ハイフンで始まらない・終わらない
• 連続ハイフン禁止

良い例: data-analyzer, pdf-processor, email-sender 悪い例: DataAnalyzer, data_analyzer, -invalid-, too--many

SKILL.md フォーマット詳細

フロントマター（YAML）

本文（Markdown）

• スキルの詳細な使用方法
• ワークフローの手順
• 使用可能なリソース（scripts, references）の説明
• 入力/出力の例
• 制約事項

パッケージング（オプション）

スキルを配布可能な.skillファイルにパッケージ化：

python skills/skill-creator/scripts/package_skill.py ./skills/<skill-name> ./dist

生成される.skillファイルはZIP形式で、他の環境にインポート可能。

制約

• スキル名は一意である必要がある
• 既存スキルと同名の場合はエラー（上書きは確認後のみ）
• SKILL.mdの本文は500行以下を推奨
• 大量の参照データはreferences/に分割する

参考リンク

• Agent Skills Overview
• Agent Skills Best Practices
• Skills Cookbook