mcpField
M
meta-skill-creator

meta-skill-creator

github.com/oakossエージェントワークフロー20107 回インストール10 週間前に更新
リポジトリ

meta-skill-creator について

Agent Skills の作成と検証を支援するスキルです。ポータブルなスキルを作る開発者向けに、ディレクトリ構成、メタデータ、内容の整理、配布上の制約、検証手順を案内します。

主な機能

  1. 01スキルのディレクトリとファイル構成
  2. 02必須・任意の frontmatter 作成
  3. 03段階的開示による内容整理
  4. 04構成と命名のよくある誤りの確認
  5. 05バリデーターによるスキル検証

活用シーン

  1. 01仕様に沿ったスキルの新規作成
  2. 02長い指示のリファレンスファイルへの分割
  3. 03配布前のスキル構成の検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oakoss/agent-skills --skill meta-skill-creator

インストール後、Claude Code で/meta-skill-creatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
frontmatter.md
skill-anatomy.md
validation.md
scripts/
validate-component.py
validate-skill.py

詳細

メタスキルクリエーター

概要

エージェントスキルは、エージェントが必要に応じて見つけて読み込む、指示、スクリプト、リソースをまとめたポータブルなフォルダーです。Agent Skills オープン標準に準拠しており、Claude Code、Cursor、Gemini CLI、OpenAI Codex、VS Code、GitHub Copilot、Windsurf、Goose、Roo Code など、27 以上の互換性のあるエージェントで利用できます。このスキルでは、スキルの作成、構成、検証に関する一連のワークフローを解説します。

クイックリファレンス

概念概要主なルール
ディレクトリ構成skill-name/SKILL.md と、任意の references/、scripts/、assets/必須ファイルは SKILL.md のみ
Frontmatter（必須）name と description を含む YAML ブロックname はディレクトリ名と一致し、最大 64 文字
Frontmatter（任意）license、compatibility、metadata、allowed-toolsオープン標準で定義され、エージェント間で利用可能
エージェント固有のフィールドmodel、context、agent、hooks、user-invocableClaude Code の拡張機能であり、ポータブルではない
説明文のトリガー「Use when...」または「Use for...」のフレーズを含めるキーワードを豊富に含め、三人称で記述する
段階的な情報開示メタデータ -> 指示 -> リソース（3 段階）SKILL.md は全体を読み込み、references は必要に応じて読み込む
SKILL.md のサイズ100～150 行を目安にし、最大 500 行SKILL.md にコード例を含めない
SKILL.md のセクション概要、クイックリファレンス、よくある間違い、委任、参考資料5 つのセクションすべてが必須
参考ファイルFrontmatter を含む references/[topic].md各ファイルは最大 500 行で、単独で完結させる
参考ファイルの Frontmattertitle、description、tags フィールドすべての参考ファイルで必須
スクリプトscripts/ ディレクトリ内の実行可能なコードエージェントはソースを読むのではなく、スクリプトを実行する
名前の形式小文字、数字、ハイフン-- は不可、先頭と末尾の - は不可、4 文字以上
除外されるファイル名README.md、metadata.json、_* ファイル配布用 CLI ではインストールされない
検証skills-ref validate またはプロジェクト固有のバリデーター配布前に必ず検証する

スキル作成ワークフロー

  1. ディレクトリを作成し、適切な場所に SKILL.md を配置します
  2. Frontmatter を記述し、ディレクトリ名と一致する name と、トリガーを含む description を設定します
  3. 必須セクションを記述します：概要、クイックリファレンス、よくある間違い、委任、参考資料
  4. コード例を抽出し、references/ ファイルに移します（SKILL.md にコードを記述しないでください）
  5. プロジェクトのバリデーターまたは skills-ref validate で検証します

よくある間違い

間違い正しいパターン
「Use when」または「Use for」のトリガーがないエージェントが見つけられるよう、説明にトリガー句を含めます
SKILL.md にコード例を記載するすべてのコードを references/ ファイルに移動します
SKILL.md が500行を超えている詳細な内容をリファレンスファイルに分割します
リファレンスファイル間で相互参照するリファレンスは自己完結させ、SKILL.md から1階層に保ちます
名前がディレクトリと一致しないname フィールドは親ディレクトリ名と完全に一致させる必要があります
名前に大文字やスペースが含まれている小文字、数字、ハイフンのみを使用します
キーワードのない曖昧な説明トリガーに同義語、省略形、ライブラリ名を詰め込みます
言語指定のないコードブロックフェンス付きコードブロックには必ず言語を指定します
SKILL.md からサポートファイルへのリンクがないエージェントがファイルを見つけられるよう、SKILL.md に明示的なリンクを記載します
除外対象のファイル名を使用するREADME.md、metadata.json、_ で始まるファイルは避けます
フロントマターの前に空行がある--- は1行目に置き、その前に空行を入れてはいけません
説明が一人称で書かれている「I help you」ではなく「Extracts text」のように三人称で書きます
リファレンスの連鎖が深くネストしている1階層に保ちます。SKILL.md からリファレンスへ直接リンクします
必須の SKILL.md セクションが不足しているOverview、Quick Ref、Mistakes、Delegation、Refs の5つすべてを含めます
リファレンスファイルにフロントマターがないすべてのリファレンスに title、description、tags が必要です

スキルの配置場所

必要な公開範囲に応じて、スキルは異なるスコープにインストールできます。

場所パススコープ
個人~/.claude/skills/自分、すべてのプロジェクト
プロジェクト.claude/skills/リポジトリ内の全員
配布skills CLI 経由プラグインのユーザー

委任

  • 仕様に関する質問：Agent Skills open standardを参照してください
  • パターンの調査：Explore エージェントを使用して、既存のスキルを分析し、構造の例を確認してください
  • 検証：コミットする前に、プロジェクトのバリデーターまたは skills-ref validate を実行してください

参考資料

コメント

Markdown 対応