name: claude-plugin-creator description: Claude Code plugin creation guide. Use when creating new plugins, adding commands/skills/hooks/MCP servers to plugins, or setting up marketplace distribution. Triggers on "create plugin", "add command", "add skill", "add hook", "plugin structure".

Claude Code Plugin Creator

Guide for creating Claude Code plugins with correct structure and components.

Plugin Structure

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # Required: Plugin metadata
├── commands/                 # Optional: Slash commands
│   └── my-command.md
├── skills/                   # Optional: Agent skills
│   └── my-skill/
│       └── SKILL.md
├── hooks/                    # Optional: Event handlers
│   └── hooks.json
└── .mcp.json                # Optional: MCP servers

Quick Start

1. Create Plugin Directory

mkdir -p my-plugin/.claude-plugin

2. Create plugin.json

{
  "name": "my-plugin",
  "description": "Plugin description",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

3. Add Components

• Commands: See commands.md
• Skills: See skills.md
• Hooks: See hooks.md
• MCP Servers: See mcp.md

Adding to Marketplace

For this repository, add plugin to .claude-plugin/marketplace.json:

{
  "plugins": [
    {
      "name": "my-plugin",
      "source": "./my-plugin",
      "description": "Plugin description"
    }
  ]
}

Validation

Run validation script before committing:

./validate-plugin.sh my-plugin

Component Reference