Plugin Spec

Plugin Spec スキル（統合版）

Claude Code プラグインの全仕様知識を統合して提供する。 詳細な仕様は個別スキルを参照。

Instructions

このスキルはプラグインの各コンポーネント（commands, skills, agents, hooks）の 概要を提供し、詳細は個別スキルに委譲します。

重要: 実装前に必ず公式ドキュメント（英語版）を確認し、最新の仕様に従ってください。

公式ドキュメント

• Plugins
• Plugins Reference

Multi-tool compatibility (v1.5.0+, OpenCode は v1.6.0+)

cc-plugins のプラグインは Claude Code / Codex CLI / Cursor / Copilot CLI / OpenCode の 5 ツールで共通認識できる構造を採る。詳細は .claude/rules/plugin-development.md の "Multi-tool compatibility" セクションを参照。主要ポイント:

• 共通フロントマター: name (kebab-case)、description (1 行目を Use when ... で開始)
• AGENTS.md: プラグインに skills/agents/commands があれば必ずルートに配置。 Codex CLI / Cursor / Copilot CLI / OpenCode が読み込む入口となり、Claude Code ネイティブ定義へ参照を貼る
• .cursor/rules/plugin.mdc (任意): Cursor 向けの参照ファイル
• .github/copilot-instructions.md: リポジトリルートに 1 ファイルのみ
• Claude Code 固有フィールドの配置ルール:
  • context: fork, user-invocable → skills のみ
  • allowed-tools → skills / commands
  • model → agents / commands (skills には不可)
  • tools → agents (commands/skills は allowed-tools)
• バリデーション: .claude/scripts/lint-multi-tool-compat.sh
• テンプレート: plugins/plugin-generator/templates/{agents-md,cursor-rules.mdc}.tmpl

個別仕様スキル

各コンポーネントの詳細な仕様は上記スキルを参照してください。

plugin.json 仕様

プラグインのメタデータを定義するファイル。

必須フィールド

推奨フィールド

パスフィールド

例

{
  "name": "my-plugin",
  "description": "プラグインの説明",
  "version": "1.0.0",
  "author": { "name": "Author Name" },
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"],
  "commands": "./commands/",
  "skills": "./skills/",
  "agents": "./agents/"
}

コンポーネント概要

Commands

スラッシュコマンドを定義する Markdown ファイル。

• 配置: commands/{command-name}.md
• 必須: フロントマターに description
• オプション: model（フルモデル ID）、allowed-tools
• 詳細: command-spec スキルを参照

Skills

Claude が自動適用する知識・手順を定義する Markdown ファイル。

• 配置: skills/{skill-name}/SKILL.md
• 必須: フロントマターに name, description
• オプション: allowed-tools, context, agent, user-invocable, hooks
• 注意: model 指定は使用不可
• v2.1.0+: context: fork でサブエージェントとして実行可能
• 詳細: skill-spec スキルを参照

Agents

サブエージェントを定義する Markdown ファイル。

• 配置: agents/{agent-name}.md
• 必須: フロントマターに name, description
• オプション: tools, model（短縮名）, skills
• 詳細: agent-spec スキルを参照

Hooks

イベント発生時に自動実行されるシェルコマンドを定義。

• 配置: hooks/hooks.json
• イベント: PreToolUse, PostToolUse, SessionStart, SessionEnd など
• タイプ: command, prompt

model 指定の違い

注意: Sonnet は現在の Claude Code では推奨されません。

バリデーションルール

エラー（必須）

警告（推奨）

Examples

コンポーネント作成

Q: 新しいコマンドを作りたい
A: `/plugin-generator:create-command {name}` を実行するか、
   `command-spec` スキルを参照してください。

Q: 新しいスキルを作りたい
A: `/plugin-generator:create-skill {name}` を実行するか、
   `skill-spec` スキルを参照してください。

Q: 新しいエージェントを作りたい
A: `/plugin-generator:create-agent {name}` を実行するか、
   `agent-spec` スキルを参照してください。

プラグイン構造の相談

Q: プラグインの構造を教えて
A: 基本構造は以下の通りです:
   - .claude-plugin/plugin.json（必須）
   - commands/（スラッシュコマンド）
   - skills/（自動適用スキル）
   - agents/（サブエージェント）
   - hooks/（イベントフック）