Claude Code Plugin Marketplace Template

Create and distribute Claude Code plugins for your team or community. This GitHub template gives you a working marketplace structure, scaffolding commands, validation, and CI/CD automation.

Features

• Skip the boilerplate. Marketplace structure, plugin manifests, and GitHub Actions validation come ready to use.
• Plugin development toolkit. Scaffold plugins, add commands, skills, agents, and hooks, then validate before release.
• Team distribution. Set up automatic marketplace installation for your projects.
• Docs and a working example. Guides for every plugin component, plus a hello-world plugin you can copy.

What's Included

Component	Description
Marketplace Configuration	.claude-plugin/marketplace.json following the official schema
Plugin Development Toolkit	plugin-development plugin with 7 slash commands, a plugin-authoring skill for ambient guidance, and a reviewer agent
Example Plugin	hello-world plugin showing a minimal working structure
CI/CD Workflows	GitHub Actions that validate every plugin on each push and PR
Documentation	Guides for plugins, hooks, settings, commands, skills, and sub-agents

Quick Start

1. Create Your Marketplace

Click "Use this template" on GitHub, then clone your new repository:

git clone https://github.com/your-org/your-marketplace-name.git
cd your-marketplace-name

2. Customize the Marketplace

Update .claude-plugin/marketplace.json with your organization details:

{
  "name": "my-team-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "team@your-org.com"
  },
  "metadata": {
    "description": "A curated collection of Claude Code plugins for our team",
    "version": "1.0.0"
  },
  "plugins": []
}

3. Install the Plugin Development Toolkit

# Start Claude Code
claude

# Add your local marketplace
/plugin marketplace add .

# Install the development toolkit
/plugin install plugin-development@my-team-marketplace

4. Create Your First Plugin

# Scaffold a new plugin
/plugin-development:init my-awesome-plugin

# Add components
/plugin-development:add-command my-command "Description of what it does"
/plugin-development:add-skill my-skill "Use when working with..."

# Validate before publishing
/plugin-development:validate

Plugin Development Commands

The plugin-development plugin provides these commands:

Command	Description
/plugin-development:init [name]	Scaffold a new plugin with standard structure
/plugin-development:add-command [name] [desc]	Add a new slash command
/plugin-development:add-skill [name] [desc]	Add a new skill with SKILL.md
/plugin-development:add-agent [name] [desc]	Add a new sub-agent
/plugin-development:add-hook [event] [matcher]	Add a hook configuration
/plugin-development:validate	Validate plugin structure and configuration
/plugin-development:test-local	Create dev marketplace for local testing

Repository Structure

├── .claude-plugin/
│   └── marketplace.json          # Marketplace configuration
├── .github/
│   └── workflows/
│       └── validate-plugins.yml  # CI/CD validation
├── docs/                         # Documentation
│   ├── plugins.md                # Plugin development guide
│   ├── plugins-reference.md      # Technical specifications
│   ├── plugin-marketplaces.md    # Marketplace management
│   ├── hooks.md                  # Event-driven automation
│   ├── settings.md               # Configuration options
│   ├── slash-commands.md         # Command system reference
│   ├── skills.md                 # Agent skills guide
│   └── sub-agents.md             # Sub-agent system
└── plugins/
    ├── hello-world/              # Example plugin
    └── plugin-development/       # Development toolkit

Team Distribution

Configure automatic marketplace installation for your team by adding .claude/settings.json to your projects:

{
  "extraKnownMarketplaces": {
    "my-team-marketplace": {
      "source": {
        "source": "github",
        "repo": "your-org/your-marketplace-name"
      }
    }
  }
}

When team members trust the repository folder, Claude Code installs the marketplace for them. See Configure team marketplaces for details.

Installing from GitHub

Once your marketplace is published to GitHub, users can install plugins with:

# Add the marketplace
/plugin marketplace add your-org/your-marketplace-name

# Install a plugin
/plugin install plugin-name@your-marketplace-name

Local Testing

Test your plugins before publishing:

# Navigate to your marketplace
cd your-marketplace-name

# Start Claude Code
claude

# Add local marketplace
/plugin marketplace add .

# Install and test a plugin
/plugin install hello-world@my-team-marketplace
/hello World

For iterative development:

# After making changes
/plugin-development:validate
/plugin uninstall plugin-name@my-team-marketplace
/plugin install plugin-name@my-team-marketplace

Uninstalling

Remove the marketplace and its plugins from Claude Code:

# Remove a specific plugin
/plugin uninstall plugin-name@my-team-marketplace

# Remove the marketplace entirely
/plugin marketplace remove my-team-marketplace

To remove everything, delete the cloned repository directory.

Creating Plugins Manually

If you prefer manual setup over the scaffolding commands:

1. Create Plugin Directory

mkdir -p plugins/my-plugin/.claude-plugin
mkdir -p plugins/my-plugin/commands

2. Add Plugin Manifest

Create plugins/my-plugin/.claude-plugin/plugin.json:

{
  "name": "my-plugin",