Plugins（プラグイン）

Plugins は、Claude Code の機能拡張（Skills、Agents、Hooks、MCP サーバー等）を1つのパッケージにまとめて配布・共有できる仕組みです。ブラウザの拡張機能のように、誰でも簡単にインストールして同じ機能を使えます。

Plugins とは

身近な例えで理解する

Claude Code も同じです。.claude/ に直接書いた Skills や Hooks はそのプロジェクトでしか使えませんが、Plugin にすればチームメンバーや他のプロジェクトに簡単に配布できます。

なぜ Plugins が必要なのか

1. .claude/ の設定との使い分け

2. 名前空間で衝突を防ぐ

複数のプラグインが同じ名前のスキルを持っていても、/plugin-a:deploy と /plugin-b:deploy のように名前空間で区別されるため衝突しません。

3. バージョン管理と更新

plugin.json にバージョンを記載することで、セマンティックバージョニングによる管理ができます。更新も /plugin install で簡単です。

Plugin の構成

Plugin は以下のディレクトリ構造で構成されます。

my-plugin/
├── .claude-plugin/
│   └── plugin.json        # マニフェスト（必須）
├── commands/               # カスタムコマンド
│   └── hello.md
├── skills/                 # スキル
│   └── code-review/
│       └── SKILL.md
├── agents/                 # サブエージェント
│   └── reviewer.md
├── hooks/                  # フック
│   └── hooks.json
├── .mcp.json               # MCP サーバー設定
├── .lsp.json               # LSP サーバー設定
├── settings.json           # デフォルト設定
└── README.md               # プラグイン説明

plugin.json（マニフェスト）

マニフェストファイルはプラグインのメタ情報を定義します。.claude-plugin/plugin.json に配置します。

{
  "name": "my-plugin",
  "description": "プラグインの説明",
  "version": "1.0.0",
  "author": {
    "name": "作者名"
  }
}

サンプルプラグイン

スターターキットの .claude/plugins/sample-plugin/ に最小構成のサンプルプラグインがあります。これはあくまでも構成の参考例です。

ディレクトリ構造

sample-plugin/
├── .claude-plugin/
│   └── plugin.json          # マニフェスト
└── skills/
    └── hello/
        └── SKILL.md         # サンプルスキル

plugin.json

{
  "name": "sample-plugin",
  "description": "Claude Code Plugin の構成を示すサンプルプラグインです。実際のプラグイン作成の参考にしてください。",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

SKILL.md（サンプルスキル）

---
name: hello
description: ユーザーに挨拶して、どんなお手伝いができるか尋ねるサンプルスキル
disable-model-invocation: true
---

$ARGUMENTS さんに親しみを込めて挨拶し、今日どんなお手伝いができるか尋ねてください。

名前が指定されていない場合は「こんにちは！」と一般的な挨拶をしてください。

このスキルはプラグイン経由で読み込まれた場合、/sample-plugin:hello として名前空間付きで利用できます。

プラグインの作り方（ステップバイステップ）

ステップ1: ディレクトリ作成

# プラグインディレクトリを作成
mkdir -p my-plugin/.claude-plugin

ステップ2: マニフェスト作成

{
  "name": "my-plugin",
  "description": "マイプラグインの説明",
  "version": "1.0.0",
  "author": {
    "name": "あなたの名前"
  }
}

ステップ3: スキルを追加

# スキルディレクトリを作成
mkdir -p my-plugin/skills/greet

---
name: greet
description: チームメンバーに挨拶するスキル
---

$ARGUMENTS さんにチームの一員として挨拶し、
今日の作業予定を確認してください。

ステップ4: ローカルテスト

# プラグインを読み込んでClaude Codeを起動
claude --plugin-dir ./my-plugin

# 変更を反映（再起動不要）
/reload-plugins

# スキルのテスト（名前空間付き）
/my-plugin:greet 田中さん

ステップ5: カスタムコマンドやエージェントを追加（任意）

# コマンドを追加
mkdir -p my-plugin/commands
echo "レビューの指示内容..." > my-plugin/commands/review.md

# エージェントを追加
mkdir -p my-plugin/agents
echo "セキュリティレビューの指示..." > my-plugin/agents/security-reviewer.md

.claude/ からの変換手順

既に .claude/ に Skills や Hooks がある場合、以下の手順で Plugin に変換できます。

# 1. プラグインディレクトリを作成
mkdir -p my-plugin/.claude-plugin

# 2. マニフェストを作成
echo '{"name":"my-plugin","description":"説明","version":"1.0.0"}' > my-plugin/.claude-plugin/plugin.json

# 3. 既存ファイルをコピー
cp -r .claude/commands my-plugin/
cp -r .claude/skills my-plugin/
cp -r .claude/agents my-plugin/

# 4. テスト
claude --plugin-dir ./my-plugin

Skills との関係

Skills は Plugin の中核的な構成要素です。.claude/skills/ に直接配置したスキルとプラグイン内のスキルの違いを理解しましょう。

配布方法