Sample

Claude Code Plugin Marketplace

Claude Code プラグインを配布・共有するためのマーケットプレイスです。

概要

このリポジトリは、Claude Code のプラグインマーケットプレイスとして機能します。チームごとにディレクトリを分けてプラグインを管理し、マーケットプレイス経由で簡単にインストールできます。

ディレクトリ構成

claude-code-plugins/
├── .claude-plugin/
│   └── marketplace.json       # マーケットプレイス定義
├── plugins/
│   ├── sample/                # チーム "sample" のプラグイン
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/          # スラッシュコマンド
│   │   └── agents/            # サブエージェント
│   └── <team_name>/         # 他チームのプラグイン
├── CLAUDE.md
└── README.md

各チームが plugins/<team_name>/ 配下に独自のプラグインを配置します。

マーケットプレイスの利用方法

マーケットプレイスの追加

Claude Code 内で以下のコマンドを実行してください:

/plugin marketplace add mu-suke/claude-code-plugins

プラグインのインストール

マーケットプレイスの追加後、以下のコマンドでプラグインをインストールできます:

# 利用可能なプラグインを確認
/plugin

# プラグインをインストール（team_name を指定）
/plugin install sample@claude-code-plugins

プラグインの更新

/plugin marketplace update

プラグインの追加方法

新しいチームとしてプラグインを追加する手順:

1. プラグインディレクトリを作成

plugins/<team_name>/ 配下にプラグインの構成要素を配置します:

plugins/<team_name>/
├── .claude-plugin/
│   └── plugin.json          # プラグインマニフェスト
├── commands/                # スラッシュコマンド（.md ファイル）
├── skills/                  # Agent Skills（SKILL.md を含むディレクトリ）
├── agents/                  # サブエージェント定義（.md ファイル）
├── hooks/                   # フック設定
│   └── hooks.json
├── .mcp.json                # MCP サーバー設定
└── .lsp.json                # LSP サーバー設定

注意: commands/、skills/、agents/、hooks/ は .claude-plugin/ ディレクトリの中ではなく、プラグインルートに配置してください。.claude-plugin/ には plugin.json のみが入ります。

2. プラグインマニフェストを作成

plugins/<team_name>/.claude-plugin/plugin.json:

{
  "name": "<team_name>",
  "description": "プラグインの説明",
  "version": "1.0.0",
  "author": {
    "name": "<team_name>"
  }
}

3. マーケットプレイスに登録

.claude-plugin/marketplace.json の plugins 配列にエントリを追加します:

{
  "name": "<team_name>",
  "source": "<team_name>",
  "description": "プラグインの説明"
}

4. ローカルでテスト

# プラグイン単体のテスト
claude --plugin-dir ./plugins/<team_name>

# マーケットプレイス経由のテスト
claude
/plugin marketplace add ./
/plugin install <team_name>@claude-code-plugins

5. バリデーション

claude plugin validate .

公開中のプラグイン

プラグイン名	説明	インストール
sample	サンプルプラグイン - hello world コマンドとコードレビューエージェント	/plugin install sample@claude-code-plugins

プラグインの構成要素

要素	説明
Commands (commands/)	/<team_name>:<command> 形式で呼び出すコマンド
Skills (skills/)	Claude が自動的にタスクに応じて使用するスキル
Agents (agents/)	特定のタスクに特化したサブエージェント
Hooks (hooks/hooks.json)	Claude Code のイベントに応じて実行されるハンドラ
MCP Servers (.mcp.json)	外部ツール・サービスとの連携
LSP Servers (.lsp.json)	コードインテリジェンスの提供

参考資料

• Plugins - プラグインの作成方法
• Plugins Reference - プラグインの技術リファレンス
• Plugin Marketplaces - マーケットプレイスの作成と配布
• Slash Commands - スラッシュコマンド
• Sub-agents - サブエージェント
• MCP - Model Context Protocol
• Hooks - フックガイド