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 fields in .claude-plugin/plugin.json :

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

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

References

• marketplace-schema.md - Full marketplace fields

• plugin-schema.md - Full plugin fields

• validation-guide.md - Debugging validation errors

• distribution.md - Publishing to GitHub