プラグインを作成する

​

プラグインとスタンドアロン設定を使い分ける

• 単一のプロジェクト用に Claude Code をカスタマイズしている
• 設定が個人的で共有する必要がない
• スキルやフックをパッケージ化する前に実験している
• /hello や /review のような短いスキル名が必要

• 機能をチームまたはコミュニティと共有したい
• 複数のプロジェクト全体で同じスキル/エージェントが必要
• 拡張機能のバージョン管理と簡単な更新が必要
• マーケットプレイスを通じて配布している
• /my-plugin:hello のような名前空間付きスキルで問題ない（名前空間はプラグイン間の競合を防ぎます）

​

クイックスタート

​

前提条件

• Claude Code インストール済みで認証済み
• Claude Code バージョン 1.0.33 以降（claude --version で確認）

​

最初のプラグインを作成する

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

• プラグインマニフェスト（.claude-plugin/plugin.json）：プラグインのメタデータを説明します
• スキルディレクトリ（skills/）：カスタムスキルを含みます
• スキル引数（$ARGUMENTS）：動的な動作のためにユーザー入力をキャプチャします

​

プラグイン構造の概要

​

より複雑なプラグインを開発する

​

プラグインにスキルを追加する

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

---
name: code-review
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

​

プラグインに LSP サーバーを追加する

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

​

プラグインでデフォルト設定を配布する

{
  "agent": "security-reviewer"
}

​

複雑なプラグインを整理する

​

プラグインをローカルでテストする

claude --plugin-dir ./my-plugin

• /plugin-name:skill-name でスキルを試す
• /agents にエージェントが表示されることを確認する
• フックが期待通りに機能することを確認する

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

​

プラグインの問題をデバッグする

1. 構造を確認する：ディレクトリが .claude-plugin/ 内ではなく、プラグインルートにあることを確認します
2. コンポーネントを個別にテストする：各コマンド、エージェント、フックを個別に確認します
3. 検証とデバッグツールを使用する：CLI コマンドとトラブルシューティング技術については、デバッグと開発ツールを参照してください

​

プラグインを共有する

1. ドキュメントを追加する：インストールと使用方法の指示を含む README.md を含めます
2. プラグインをバージョン管理する：plugin.json でセマンティックバージョニングを使用します
3. マーケットプレイスを作成または使用する：プラグインマーケットプレイスを通じて配布してインストールします
4. 他のユーザーでテストする：より広い配布の前に、チームメンバーにプラグインをテストしてもらいます

​

プラグインを公式マーケットプレイスに送信する

• Claude.ai：claude.ai/settings/plugins/submit
• Console：platform.claude.com/plugins/submit

​

既存の設定をプラグインに変換する

​

移行手順

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

# コマンドをコピー
cp -r .claude/commands my-plugin/

# エージェントをコピー（ある場合）
cp -r .claude/agents my-plugin/

# スキルをコピー（ある場合）
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

​

移行時の変更点

​

次のステップ

​

プラグインユーザー向け

• プラグインを検出してインストールする：マーケットプレイスを参照してプラグインをインストール
• チームマーケットプレイスを設定する：チーム用のリポジトリレベルプラグインを設定

​

プラグイン開発者向け

• マーケットプレイスを作成して配布する：プラグインをパッケージ化して共有
• プラグインリファレンス：完全な技術仕様
• 特定のプラグインコンポーネントをさらに詳しく調べる：
  • スキル：スキル開発の詳細
  • サブエージェント：エージェント設定と機能
  • フック：イベント処理と自動化
  • MCP：外部ツール統合