---

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

Copymy-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

Copymkdir -p my-plugin/.claude-plugin

2. Create plugin.json

Copy{
  "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:

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

Validation

Run validation script before committing:

Copy./validate-plugin.sh my-plugin

Component Reference