リファレンス

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          # Plugin manifest (required)
  skills/
    skill-name/
      SKILL.md           # Skill definition (required per skill)
      references/        # Reference data files (optional)
  commands/
    command-name.md      # Command definition (one per command)
  agents/
    agent-name.md        # Agent definition (one per agent)
  README.md              # Plugin documentation (recommended)

環境変数

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

変数	説明
`$\{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）

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

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