リファレンス

marketplace.json スキーマ

マーケットプレイスマニフェストは、リポジトリルートの .claude-plugin/marketplace.json に配置されます。

トップレベルフィールド

フィールド	必須	説明
`$schema`	いいえ	バリデーション用 JSON Schema URL
`name`	はい	マーケットプレイスの一意の識別子
`version`	いいえ	マーケットプレイスのスキーマバージョン（semver）
`metadata.description`	はい	人間が読めるマーケットプレイスの説明
`owner.name`	はい	マーケットプレイスを所有する組織またはユーザー
`owner.url`	いいえ	オーナーのプロフィールまたはウェブサイトの URL
`owner.email`	いいえ	連絡先メールアドレス
`plugins`	はい	プラグインエントリの配列

プラグインエントリフィールド

フィールド	必須	説明
`name`	はい	プラグイン識別子（`plugin.json` と一致する必要があります）
`description`	はい	プラグインの短い説明
`version`	はい	セマンティックバージョン文字列
`author.name`	はい	プラグインの作者
`source`	はい	プラグインへのパスまたは URL（ソースタイプを参照）
`category`	はい	プラグインカテゴリ（例：`productivity`）
`homepage`	いいえ	プラグインのドキュメントまたはホームページの URL
`license`	いいえ	SPDX ライセンス識別子
`keywords`	いいえ	検索キーワードの配列
`tags`	いいえ	フィルタリング用タグの配列
`repository`	いいえ	リポジトリ URL

プラグインソースタイプ

marketplace.json の source フィールドは複数の形式をサポートしています：

タイプ	例	説明
相対パス	`./plugins/example-plugin`	同一リポジトリ内のプラグイン
GitHub 省略形	`owner/repo`	リポジトリルートのプラグイン
パス付き GitHub	`owner/repo/path/to/plugin`	サブディレクトリ内のプラグイン
Git URL	`https://github.com/owner/repo.git`	Git リポジトリ
npm パッケージ	`npm:@scope/package`	公開済み npm パッケージ

plugin.json スキーマ

各プラグインは、そのディレクトリ内の .claude-plugin/plugin.json にマニフェストを持ちます。

フィールド	必須	説明
`name`	はい	プラグイン識別子
`description`	はい	プラグインの機能
`version`	はい	セマンティックバージョン
`author.name`	はい	プラグインの作者
`author.url`	いいえ	作者のプロフィールまたはウェブサイトの URL
`homepage`	いいえ	ドキュメント URL
`keywords`	いいえ	検索キーワード
`license`	いいえ	SPDX ライセンス識別子
`repository`	いいえ	リポジトリ URL

プラグインディレクトリ構成

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # プラグインマニフェスト（必須）
  skills/
    skill-name/
      SKILL.md           # スキル定義（スキルごとに必須）
      references/        # 参照データファイル（任意）
  commands/
    command-name.md      # コマンド定義（コマンドごとに1つ）
  agents/
    agent-name.md        # エージェント定義（エージェントごとに1つ）
  README.md              # プラグインドキュメント（推奨）

環境変数

プラグインはスキルおよびコマンドファイル内で以下の変数を使用できます：

変数	説明
`$\{CLAUDE_PLUGIN_ROOT\}`	プラグインのルートディレクトリへの絶対パス

バリデーション

マーケットプレイスおよびプラグインマニフェストをローカルで検証します：

claude plugin validate .

これにより以下を確認します：

marketplace.json スキーマへの準拠
参照されているすべてのプラグインディレクトリが存在すること
各プラグインが有効な plugin.json を持つこと
スキルが適切な形式の SKILL.md フロントマターを持つこと
コマンドが必須フロントマターフィールドを持つこと

チーム設定

マーケットプレイスの事前設定

任意のリポジトリの .claude/settings.json に追加します：

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

プラグインの事前有効化

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

トラブルシューティング

マーケットプレイスが見つからない

マーケットプレイスが追加されていることを確認します：

/plugin marketplace list

見つからない場合は、再度追加します：

/plugin marketplace add f5-sales-demo/marketplace

プラグインがアクティブにならない

プラグインがインストールされていることを確認します： /plugin list
Claude Code のバージョンがプラグインをサポートしているか確認します（v1.0.33 以上）
スキルのトリガー条件が現在のコンテキストと一致しているか確認します

スキルが自動的にトリガーされない

スキルは SKILL.md フロントマターの description フィールドに基づいてアクティブになります。スキルが期待どおりにアクティブにならない場合：

説明がトリガーコンテキストを正確に表しているか確認します
回避策として、コマンドを直接使用します（例：/f5xc-docs-tools:review-mdx）

レビュー後のビルドエラー

プラグインは問題を報告しますが、自動修正は行いません。提案された修正を手動で適用してから、レビューを再実行して解決を確認してください。