skill-creator

nomhiro's avatarfrom nomhiro

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

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads
[Prompt Templates and Packaging]

When & Why to Use This Skill

The Skill Creator is a powerful meta-skill designed to streamline the development of new Claude agent capabilities. It automates the entire lifecycle of skill creation—from requirement gathering and directory initialization to SKILL.md generation, validation, and packaging—ensuring all custom skills adhere to Anthropic's best practices and structural requirements.

Use Cases

  • Rapidly bootstrapping new custom agent skills with standardized directory structures (scripts, references, assets) and boilerplate code.
  • Automating the generation of SKILL.md files with correctly formatted YAML frontmatter to ensure high-quality tool discovery and invocation.
  • Validating custom-developed skills against official naming conventions and character limits to prevent deployment errors.
  • Packaging complex agent capabilities into portable .skill files for distribution, sharing, or migration between different environments.
nameskill-creator
description|
authoranthropic
version1.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/に分割する

参考リンク