Claude Code Marketplace Validator

claude-code-marketplace-validator

A CLI tool to validate [Claude Code Marketplace](https://code.claude.com) configuration files (`.claude-plugin/marketplace.json`).

Ensures plugin definitions are correct, complete, and follow best practices before publishing to the Claude Code Marketplace. Based on the [official plugin marketplace documentation](https://code.claude.com/docs/en/plugin-marketplaces).

Installation

# Install globally
npm install -g claude-code-marketplace-validator

# Or run directly with npx
npx claude-code-marketplace-validator validate .claude-plugin/marketplace.json

Quick Start

# Validate marketplace.json in current directory
marketplace-validator validate

# Validate a specific file
marketplace-validator validate .claude-plugin/marketplace.json

# Strict mode (treat warnings as errors)
marketplace-validator validate --strict

# JSON output for CI/CD
marketplace-validator validate --format json

Usage

marketplace-validator validate [file] [options]

Arguments:
  file                     Path to marketplace.json (default: "./marketplace.json")

Options:
  -f, --format       Output format: text, json, compact (default: "text")
  --strict                 Treat warnings as errors (default: false)
  -q, --quiet              Only output errors, suppress warnings and info (default: false)
  --no-color               Disable colored output
  -V, --version            Output version number
  -h, --help               Display help

Validation Rules

Errors

Rule	Description
E001	Missing required field (name, owner, plugins, plugin name, plugin source)
E002	Invalid type for a field
E003	Invalid semantic version (must follow semver: MAJOR.MINOR.PATCH)
E004	Invalid email format
E005	Invalid URL format
E006	Invalid category (must be one of: development, productivity, testing, database, deployment, design, learning, monitoring, sec