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

| Component | Location | Format | Trigger | |-----------|----------|--------|---------| | Commands | commands/*.md | Markdown + frontmatter | User: /command | | Skills | skills/*/SKILL.md | Markdown + frontmatter | Auto (context) | | Hooks | hooks/hooks.json | JSON | Events | | MCP | .mcp.json | JSON | Auto |