Skip to content

MARKETPLACE_CHECKLIST.md

Latest commit

 

History

History
100 lines (73 loc) · 2.68 KB

MARKETPLACE_CHECKLIST.md

File metadata and controls

100 lines (73 loc) · 2.68 KB

Marketplace Checklist

This checklist ensures the repository adheres to Claude Code marketplace requirements.

Required Files ✓

  • .claude-plugin/marketplace.json - Marketplace catalog
  • README.md - Installation and usage instructions
  • LICENSE - License file

Marketplace JSON Structure ✓

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

  • name - Marketplace identifier
  • version - Semantic versioning
  • description - One-line summary
  • plugins - Array of plugin entries

Optional but recommended:

  • author - Author information
  • homepage - Repository URL
  • repository - Git repository URL
  • license - License identifier

Plugin Entries ✓

Each plugin in the plugins array must have:

  • name - Plugin identifier (matches plugin manifest)
  • displayName - Human-readable name
  • description - Brief description
  • version - Plugin version
  • author - Plugin creator
  • source - Download location with type, owner, repo

Optional:

  • keywords - Search tags
  • homepage - Plugin documentation URL
  • repository - Repository URL
  • license - License identifier

Plugin Structure

Each plugin in plugins/ directory must have:

  • .claude-plugin/manifest.json (or plugin.json)
  • README.md - Plugin documentation
  • At least one component (commands/, skills/, agents/, hooks/)

Current plugins:

  • agent-orchestrator ✓

Validation Commands

# Validate marketplace JSON syntax
jq . .claude-plugin/marketplace.json

# Check required fields
jq -e '.name and .version and .description and .plugins' .claude-plugin/marketplace.json

# Validate each plugin entry
jq -e '.plugins[] | .name and .displayName and .description and .version and .author and .source' .claude-plugin/marketplace.json

# Check plugin manifest
jq . plugins/agent-orchestrator/.claude-plugin/plugin.json

Testing Installation

# Add marketplace locally
/plugin marketplace add /path/to/Claude-Code-Plugins

# Install plugin
/plugin install agent-orchestrator@claude-code-plugins

# Verify plugin loaded
/plugin list

Distribution

Once pushed to GitHub, users can install with:

/plugin marketplace add L3DigitalNet/Claude-Code-Plugins
/plugin install agent-orchestrator@claude-code-plugins

Updating the Marketplace

When adding or updating plugins:

  1. Update plugin files in plugins/
  2. Update plugin entry in .claude-plugin/marketplace.json
  3. Bump marketplace version:
    • Patch (1.0.1) - Plugin updates, fixes
    • Minor (1.1.0) - New plugins added
    • Major (2.0.0) - Breaking changes
  4. Update README.md if needed
  5. Commit and push to GitHub