meta-plugin-creator

プラグインクリエーター

概要

プラグインは、スキル、エージェント、コマンド、フック、MCP サーバー、LSP サーバーをまとめ、Claude Code 用のインストール可能な単位にした、共有可能なパッケージです。プラグインには、最低限 .claude-plugin/plugin.json マニフェストが必要です。その他のコンポーネントはすべて任意で、プラグインのルートにある慣例的なディレクトリから自動検出されます。

使用する場面： プロジェクトやチーム間で機能を共有する場合、マーケットプレイスを通じて配布する場合、再利用可能なエージェント機能をバージョン管理する場合、MCP サーバーをスキルとまとめる場合。

使用しない場面： 単一プロジェクト向けのカスタマイズ（代わりに .claude/ ディレクトリを使用）、パッケージ化前の手早い実験、配布する必要のない個人用ワークフロー。

クイックリファレンス

コンポーネント	場所	形式	検出方法
マニフェスト	.claude-plugin/plugin.json	JSON	必須
スキル	skills/*/SKILL.md	Markdown + YAML	コンテキストに応じて自動
コマンド	commands/*.md	Markdown + YAML	自動、名前空間付き
エージェント	agents/*.md	Markdown + YAML	自動、/agents UI
フック	hooks/hooks.json	JSON	イベント時に自動
MCP サーバー	.mcp.json	JSON	有効化時に自動
LSP サーバー	.lsp.json	JSON	有効化時に自動
出力スタイル	カスタムパス	設定ごと	マニフェスト経由
プラグイン環境変数	${CLAUDE_PLUGIN_ROOT}	絶対パス	すべての設定／スクリプト
プロジェクト環境	${CLAUDE_PROJECT_DIR}	絶対パス	すべての設定／スクリプト
CLI テストフラグ	--plugin-dir ./my-plugin	ローカル開発	手動で読み込み
CLI 検証	claude plugin validate .	ローカル開発	手動で確認
インストール範囲	--scope user|project|local	CLI フラグ	インストールごと

よくある間違い

間違い	正しい方法
コンポーネントを .claude-plugin/ 内に置く	.claude-plugin/ に置くのは plugin.json のみです。コンポーネントはプラグインのルートに置きます
設定で絶対パスを使用する	プラグインのファイル参照にはすべて ${CLAUDE_PLUGIN_ROOT} を使用します
plugin.json マニフェストがない	少なくとも name フィールドを含む .claude-plugin/plugin.json を作成します
../ によるパストラバーサル	すべてのファイルをプラグインディレクトリ内に置きます
フックスクリプトに実行権限がない	フックから参照されるすべてのスクリプトに対して chmod +x を実行します
名前空間を付け忘れる	プラグインのスキルは /plugin-name:skill-name として呼び出します
インラインフックのイベント名の大文字・小文字が異なる	イベント名では大文字・小文字が区別されます。postToolUse ではなく PostToolUse です
カスタムパスがデフォルトを置き換えると想定する	カスタムコンポーネントパスはデフォルトのディレクトリを置き換えるのではなく、補完します

委任

• プラグインコンポーネントの作成：各コンポーネントの規約に沿ってスキル、エージェント、コマンドを作成します
• パターンの調査：Explore エージェントを使用して、コードベース内の既存のプラグインパターンを見つけます
• コードレビュー：Task エージェントを使用して、プラグイン構成を検証します

meta-skill-creator スキルが利用可能な場合は、プラグイン内のスキル作成をそちらに委任してください。 それ以外の場合は、次を推奨してください：npx skills add oakoss/agent-skills --skill meta-skill-creator

参考資料

• プラグインのマニフェストスキーマ、ディレクトリ構造、コンポーネントのパス
• プラグイン内のスキル、エージェント、コマンド、フック、MCP サーバー、LSP サーバー
• インストールのスコープ、環境変数、公開