plugin-marketplace-setup

プラグインとスキルのマーケットプレイス設定

スキル（ポータブルな指示）、プラグイン（実行時の連携）、マーケットプレイス（カタログ）を混同せずに提供します。

3 つのレイヤー（規範）

レイヤー	内容	インストール単位	Skill Steward の配置先
スキル	agentskills.io に準拠した SKILL.md	npx skills add owner/repo --skill name	skills/{name}/
プラグイン	Open Plugin またはベンダーのマニフェストと、フック／MCP／ルール／コマンド	エージェントごと（マトリックスを参照）	plugins/{id}/ (ADR 0004)
マーケットプレイス	プラグイン／スキルのカタログ	マーケットプレイスを追加してから、プラグインをインストール	製品のリポジトリ。Skill Steward では公開 Git と skills.sh を使用

ルール： 指示のみの場合は スキル。イベントフックまたは複数ファイルにまたがる連携がある場合は プラグイン（スキルを ID で参照し、SKILL.md をフォークしないでください）。

Skill Steward のメタプラグインの意味： 宣言型マニフェスト、参照するスキル ID、フック／ルールのスニペット、検証済みの連携アーティファクトを指します。ホストのマーケットプレイスへの登録が完了したことを意味するものではなく、Cursor／Codex／Claude の設定を暗黙に変更することもありません。ホスト固有のインストール手順は、README／ドキュメントに明記してください。

公開と非公開（判断基準）

目的	推奨チャネル	備考
公開ディスカバリー	GitHub の公開リポジトリ + skills.sh	npx skills add owner/repo。インデックスには有効な skills/*/SKILL.md が必要です
チーム専用スキル（すべてのエージェント）	GitHub／GitLab の非公開リポジトリ	エージェントがクローンできる場合は、同じく npx skills add org/private-repo を使用します。デプロイキー／SSO を使用してください
Cursor チームプラグイン	チームマーケットプレイス — Dashboard → Settings → Plugins → Import repo	Teams／Enterprise 向け。.cursor-plugin/marketplace.json を含む GitHub の非公開リポジトリ
Claude Code チーム	非公開 Git マーケットプレイス	自動更新にはトークン環境変数を設定して /plugin marketplace add を使用します（Claude のドキュメント）
Codex チーム	$REPO_ROOT/.agents/plugins/marketplace.json または ~/.agents/plugins/marketplace.json	リポジトリ／個人用マーケットプレイス。アプリまたは CLI からインストールします
Zed のスキル	.agents/skills/ または ~/.agents/skills/	スキルのみ。Zed にはリモートスキルレジストリも、カスタム検索パスもありません
npm の非公開スキルパッケージ	Claude マーケットプレイスの source.type: npm	npm でホストされるプラグインバンドル向け。通常の SKILL.md ツリーでは一般的ではありません

Skill Steward のデフォルト： メタスキルには公開リポジトリ arenukvern/skill_steward を使用し、フックは別途説明します（npx skills では Cursor のフックはインストールされません）。

エージェント横断のインストールマトリックス（スキル）

共有インストーラーとして vercel-labs/skills を使用します：

npx skills add owner/repo                    # all skills, project scope
npx skills add owner/repo --skill my-skill   # one skill
npx skills add owner/repo -a cursor -a claude-code -a codex -a zed -y
npx skills add owner/repo -g                 # global (~/.agents/skills/)
npx skills add owner/repo --copy             # copy instead of symlink

ディスカバリーでは、Claude マーケットプレイスとの互換性のため、.claude-plugin/plugin.json と .claude-plugin/marketplace.json のスキルパスも読み取ります。

エージェント	--agent フラグ	プロジェクトのスキルパス	グローバルスキルパス
Cursor	cursor	.agents/skills/（Cursor は .cursor/skills/ も読み取ります）	~/.cursor/skills/
Claude Code	claude-code	.claude/skills/	~/.claude/skills/
Codex	codex	.agents/skills/	~/.codex/skills/
Zed	zed	.agents/skills/	~/.agents/skills/
Copilot、Windsurf、Cline、…	npx skills --help を参照	CLI の表を参照	CLI の表を参照

フック： Claude Code、Cline、Kiro でサポートされています。npx skills では Cursor をサポートしていません。Cursor のフックには .cursor/hooks.json が必要です（Skill Steward の例）。

エージェント横断インストールマトリックス（プラグイン）

エージェント	マニフェストディレクトリ	マーケットプレイスファイル	インストール（一般的な方法）
Cursor	.cursor-plugin/plugin.json	.cursor-plugin/marketplace.json（複数プラグインのリポジトリ）	マーケットプレイス UI、チームインポート、または init スクリプト → .cursor/plugins/local/
Claude Code	.claude-plugin/plugin.json	.claude-plugin/marketplace.json	/plugin marketplace add owner/repo の後に /plugin install name@marketplace
Codex	.codex-plugin/plugin.json	$REPO_ROOT/.agents/plugins/marketplace.json または ~/.agents/plugins/marketplace.json	アプリのプラグインディレクトリ、または codex plugin add name@marketplace
Open Plugin v1	.plugin/plugin.json	ホスト固有	移植可能なベースライン。ホスト固有の上書きが必要な場合のみ、ベンダーのマニフェストを追加します
Open skills のみ	N/A	N/A	npx skills add — MCP/hooks はありません

参考となる製品レイアウト：製品リポジトリのマーケットプレイス配布設定。

Codex プラグインに関する注意事項

• .codex-plugin/ には plugin.json のみを置き、skills/、.mcp.json、.app.json、hooks/、assets/ はプラグインのルートに置きます。
• 付随するファイルやディレクトリが存在する場合にのみ、.codex-plugin/plugin.json に skills、mcpServers、apps、または hooks を含めます。Codex は既定の hooks/hooks.json も確認します。
• リポジトリ／チームのカタログには $REPO_ROOT/.agents/plugins/marketplace.json、個人用カタログには ~/.agents/plugins/marketplace.json を使用します。
• 各マーケットプレイスエントリには policy.installation、policy.authentication、category を含める必要があります。source.path はマーケットプレイスのルートからの相対パスとし、そのルート内に置きます。
• Codex はマーケットプレイスプラグインを ~/.codex/plugins/cache/$MARKETPLACE_NAME/$PLUGIN_NAME/$VERSION/ にインストールします。ローカルのソースを編集した場合、新しいスレッドに反映するには再インストールまたはキャッシュの更新が必要です。

Open Plugin の移植性

• Open Plugin ホスト間でベンダーに依存しないプラグインにする場合は、.plugin/plugin.json を使用します。
• ホストにベンダー固有のマニフェストが必要な場合にのみ、.codex-plugin/plugin.json、.cursor-plugin/plugin.json、または .claude-plugin/plugin.json を追加します。
• Skill Steward の plugin.yaml をホストのマーケットプレイスマニフェストと混同しないでください。これは、Skill Steward の設定を記録するためのローカルなメタプラグインマニフェストです。

新しいマーケットプレイスリポジトリのひな形を作成する

A. スキルのみのマーケットプレイス（最も簡単 — Skill Steward スタイル）

my-skills/
├── skills/
│   └── my-skill/
│       └── SKILL.md
├── skills.sh.json          # optional: skills.sh categories
├── README.md               # install commands
└── package.json            # optional: pnpm run validate

公開するには、パブリックリポジトリにプッシュして npx skills add org/my-skills を実行します。プラグインマニフェストは不要です。skills.sh.json でグループとカテゴリを定義してリポジトリページをカスタマイズする方法については、skills.sh のカスタマイズドキュメントを参照してください。

B. Codex / Claude / Cursor マーケットプレイス（複数プラグイン）

my-marketplace/
├── .agents/plugins/
│   └── marketplace.json    # Codex catalog
├── .claude-plugin/
│   └── marketplace.json    # Claude catalog, when needed
├── .cursor-plugin/
│   └── marketplace.json    # Cursor catalog, when needed
└── plugins/
    └── my-plugin/
        ├── .plugin/plugin.json
        ├── .codex-plugin/plugin.json
        ├── .claude-plugin/plugin.json
        ├── .cursor-plugin/plugin.json
        ├── skills/
        ├── hooks/
        └── .mcp.json

Codex エントリ："source": {"source": "local", "path": "./plugins/my-plugin"} とポリシー／カテゴリを指定します。Claude と Cursor では、それぞれ独自のマーケットプレイス形式を使用します。対象のエージェントに必要なベンダーツリーのみを使用してください。

C. Skill Steward メタプラグイン（フック + スキル参照）

plugins/my-hook-pack/
├── plugin.yaml
├── README.md               # manual .cursor/hooks.json steps
├── hooks.json.snippet
└── hooks/

正規のスキルは skills/ に置きます。templates/plugin/ を参照してください。

非公開マーケットプレイスのチェックリスト

1. リポジトリへのアクセス — チームが git clone できること（HTTPS トークン、SSH、または Cursor チームマーケットプレイス用の GHE アプリ）。
2. シークレット — トークンをコミットしないでください。非公開マーケットプレイスでの Claude の自動更新用に GITHUB_TOKEN / GITLAB_TOKEN を記載します。
3. インストールドキュメント — チャネルごとに README のブロックを用意します（skills CLI、Claude /plugin、Cursor ダッシュボード）。
4. バージョン管理 — リリースごとにプラグインマニフェストの version を更新します。スキルは npx skills update を使って git SHA で管理します。
5. CI — スキルを検証します（Skill Steward では pnpm run validate / dart run :steward validate）。製品リポジトリではコントラクトテストを追加します。
6. スコープ — プロジェクトへのインストール（コミット済みの .agents/skills/）と -g によるグローバルインストールのどちらかを決め、チームのルールを記載します。

Skill Steward と製品リポジトリの比較

懸念事項	Skill Steward	製品（例：製品 MCP）
スキル	メタのみ（skill-authoring-lifecycle、repository-governance-lifecycle、…）	ドメイン + MCP スキル
プラグイン	メタフック（steward-validate-on-save）	完全なバンドル：MCP + スキル + 初期化
CLI	steward validate	[toolkit-cli] init <agent>
マーケットプレイス	パブリック Git + skills.sh	Claude/Codex の Git + Cursor への申請 + Smithery

Skill Steward に製品の MCP サーバーを配置しないでください。相互に紹介してください：npx skills add arenukvern/skill_steward --skill mcp-harness-repo-maintainer。

ワークフロー：配布可能なスキルを Skill Steward に追加する

1. skill-authoring-lifecycle に従います — skills/{name}/SKILL.md。
2. skills.sh.json とルートの README.md に登録します。
3. skill_steward で pnpm run validate を実行します。
4. main にマージされた後、パブリックリポジトリから npx skills add arenukvern/skill_steward --skill {name} でインストールできるようになります。
5. 任意：skills.sh のリーダーボードに申請します（有効なスキルを含むパブリックリポジトリは自動的に掲載されます）。

ワークフロー：Skill Steward プラグインを追加する

1. templates/plugin/ を plugins/{id}/ にコピーします。
2. plugin.yaml に参照するスキルを列挙します（ID のみ）。
3. インストール方法を記載します（Cursor フックのマージなど）。
4. plugins/README.md を更新します。

アンチパターン

• フックを skills/ のみに配置し、npx skills が Cursor に連携してくれると期待する
• すべてのプラグインディレクトリに SKILL.md を重複して配置する
• 1 つのエージェントのみに言及する非公開マーケットプレイスのドキュメント
• マーケットプレイスリポジトリに計画ファイルをいつまでも残す（計画の整理を参照）

追加リソース

• distribution-matrix.md — 全チャネルの一覧表
• manifest-snippets.md — 最小限の JSON/YAML の例
• ADR 0004
• ADR 0006
• skills.sh のカスタマイズに関するドキュメント

このスキルをインストールする

npx skills add arenukvern/skill_steward --skill plugin-marketplace-setup

ソース

references/sources.md を参照してください。調査する際は、skill-source-citations に従ってください。