Skill

plugin-dev

Validates, tests, and distributes Claude Code plugins and marketplaces. Guides development with schemas, local testing commands, error fixes, and distribution prep.

Bash

developer-tools

npx claudepluginhub spences10/claude-code-toolkit --plugin toolkit-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Develop and distribute Claude Code plugins and marketplaces.

Supporting Assets

references/distribution.mdreferences/marketplace-schema.mdreferences/plugin-schema.mdreferences/validation-guide.md

SKILL.md

Similar Skills

plugin-marketplace

Guides creating, validating, and managing Claude Code plugin marketplaces including marketplace.json schema, plugin entries, and best practices for setup and distribution.

6 files5 tools

claude-code

plugin-marketplace

Guides creating and managing Claude Code plugin marketplaces. Validates marketplace.json schema, configures plugin entries, and troubleshoots repository setups.

6 files

all-skills

claude-plugins

Guides full Claude Code plugin lifecycle: scoping, initializing plugin.json, adding commands/agents/hooks/skills, validating with audits, and distributing to marketplaces.

6 files

outfitter

Stats

Parent Repo Stars27

Parent Repo Forks3

Last CommitMar 21, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Plugin Development

Develop and distribute Claude Code plugins and marketplaces.

Quick Commands

# Validate marketplace/plugin claude plugin validate . # Test local install /plugin marketplace add ./path/to/marketplace /plugin install my-plugin@marketplace-name # Check installed plugins /plugin list

Marketplace Schema

Required fields in .claude-plugin/marketplace.json:

{ "name": "marketplace-name", "owner": { "name": "Your Name" }, "plugins": [ { "name": "plugin-name", "source": "./plugins/plugin-name", "description": "What it does" } ] }

Plugin Schema

Required field in .claude-plugin/plugin.json (only name is required):

{ "name": "plugin-name", "description": "What it does", "version": "1.0.0" }

The name is also the skill namespace — skills become /plugin-name:skill-name.

Development

# Test plugin locally without installing claude --plugin-dir ./my-plugin # Reload after changes (inside Claude Code) /reload-plugins

Common Errors

Error

Fix

owner: expected object

Add "owner": { "name": "..." }

plugins.0: expected object

Change string array to object array

source: Invalid input

Use ./path/to/plugin format

Components inside .claude-plugin/

Move commands/, skills/, etc. to plugin root

References

marketplace-schema.md - Full marketplace fields

plugin-schema.md - Full plugin fields

validation-guide.md - Debugging validation errors

distribution.md - Publishing, versioning, and release channels

Plugin Development

Develop and distribute Claude Code plugins and marketplaces.

Quick Commands

# Validate marketplace/plugin
claude plugin validate .

# Test local install
/plugin marketplace add ./path/to/marketplace
/plugin install my-plugin@marketplace-name

# Check installed plugins
/plugin list

Marketplace Schema

Required fields in .claude-plugin/marketplace.json:

{
  "name": "marketplace-name",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugins/plugin-name",
      "description": "What it does"
    }
  ]
}

Plugin Schema

Required field in .claude-plugin/plugin.json (only name is required):

{
  "name": "plugin-name",
  "description": "What it does",
  "version": "1.0.0"
}

The name is also the skill namespace — skills become /plugin-name:skill-name.

Development

# Test plugin locally without installing
claude --plugin-dir ./my-plugin

# Reload after changes (inside Claude Code)
/reload-plugins

Common Errors

Error	Fix
`owner: expected object`	Add `"owner": { "name": "..." }`
`plugins.0: expected object`	Change string array to object array
`source: Invalid input`	Use `./path/to/plugin` format
Components inside `.claude-plugin/`	Move `commands/`, `skills/`, etc. to plugin root

References

marketplace-schema.md - Full marketplace fields
plugin-schema.md - Full plugin fields
validation-guide.md - Debugging validation errors
distribution.md - Publishing, versioning, and release channels