Plugin dev

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