skill-creator

nomhiro 的头像作者 nomhiro

新しいしいキルを対话形式で作成するメタキル。キルの作成、新规キル追加、カカタムキル开発、キルテンプureーto生生成をサポート。要素をヒaruringuし、SKILL.md、scripts/、references/を自动生成する。使用当用户要求创建新技能、添加自定义技能或开发代理功能时。

📖 中文导读:新しいしいキルを対话形式で作成するメタキル。キルの作成、新规キル追加、カカタムキル开発、キルテンプureーto生生成をサポート。要素をヒaruringuし、SKILL.md、scripts/、references/を自动生成する。使用当用户要求创建新技能、添加自定义技能或开发代理功能时。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: skill-creator description: | 新しいスキルを対話形式で作成するメタスキル。 スキルの作成、新規スキル追加、カスタムスキル開発、スキルテンプレート生成をサポート。 要件をヒアリングし、SKILL.md、scripts/、references/を自動生成する。 Use when user asks to create a new skill, add custom skill, or develop agent capabilities. allowed-tools: - bash - python metadata: author: anthropic version: 1.0.0

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/に分割する

参考リンク