marketplace-validate

Detect and repair structural issues in claude-code-plugin marketplace data.

35|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/sean-sunagaku/claude-code-plugin --skill marketplace-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marketplace-validate
Source: https://github.com/sean-sunagaku/claude-code-plugin/tree/main/.internal/marketplace-validate/skills/marketplace-validate
Command: npx skills add https://github.com/sean-sunagaku/claude-code-plugin --skill marketplace-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate and repair structural issues in claude-code-plugin's marketplace data to ensure plugin discovery and CI validation can proceed reliably.

Core Features & Use Cases

  • Validates marketplace.json against the allowed schema and required fields.
  • Detects missing .claude-plugin/plugin.json, incomplete SKILL.md frontmatter, and orphaned entries.
  • Provides guidance for CI workflows and repository audits to keep the marketplace healthy.

Quick Start

Run the marketplace validator to detect and fix marketplace.json errors.

Frequently Asked Questions about marketplace-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate marketplace.json structure and required fields?

To validate marketplace.json structure, run the marketplace validator to enforce allowed schema keys and detect missing required fields. The validator identifies structural issues and provides automated repairs to ensure plugin discovery and CI validation proceed reliably.

What causes orphaned entries in marketplace data and how do I fix them?

Orphaned entries in marketplace data occur when plugin references lack corresponding files or registration. The validator detects these orphaned entries, identifies missing .claude-plugin/plugin.json files, and synchronizes plugin.json data with marketplace entries when possible to repair the structure.

Can I use marketplace validation in CI workflows for plugin publishing?

Yes, marketplace validation applies across CI validation workflows and plugin publishing pipelines. It catches missing plugin.json files, incomplete SKILL.md frontmatter, and unregistered skills automatically during routine repository maintenance to keep the marketplace healthy.

How do I detect unregistered skills and incomplete frontmatter in my plugin repository?

To detect unregistered skills and incomplete frontmatter, run the marketplace validator against your repository. It identifies missing .claude-plugin/plugin.json files and incomplete SKILL.md frontmatter, detecting orphaned entries and synchronizing plugin.json data with marketplace entries when possible.

What are the limitations of automated marketplace structure repair?

Automated marketplace structure repair synchronizes plugin.json data with marketplace entries when possible, but cannot resolve all structural issues autonomously. It detects unregistered skills and enforces allowed keys in marketplace.json, providing guidance for manual fixes when automated synchronization is not feasible.