validate-marketplace

Validate Claude Code marketplace metadata across JSON, README, and SKILL.md files.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill validate-marketplace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-marketplace
Source: https://github.com/mattbobambrose/mattbobambrose-claude-skills/tree/main/plugins/project-tools/skills/validate-marketplace
Command: npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill validate-marketplace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates validation of a Claude Code marketplace repository to surface inconsistencies between marketplace.json, individual plugin.json files, SKILL.md declarations, and README catalog entries. It helps maintainers detect missing plugins, version mismatches, orphan entries, inaccurate skill counts, and naming convention violations before publishing or updating the marketplace.

Core Features & Use Cases

  • Cross-file consistency checks: Verify each plugin has a marketplace entry and each marketplace entry maps to an actual plugin directory.
  • Metadata and documentation validation: Confirm versions match between plugin.json and marketplace.json, ensure SKILL.md frontmatter contains required fields, and validate README catalog completeness and skill counts.
  • Use Case: When preparing a marketplace update, run this skill to produce a pass/fail report that pinpoints missing or mismatched entries so maintainers can fix issues before users encounter installation errors.

Quick Start

Run validate-marketplace to scan the repository and produce a validation report listing passes and failures for marketplace.json, plugin.json, SKILL.md frontmatter, naming conventions, and README catalog entries.

Frequently Asked Questions about validate-marketplace

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

FAQPage Schema
How do I validate marketplace metadata for a Claude Code plugin repository?

Validate marketplace metadata by scanning marketplace.json, plugin.json, SKILL.md, and README entries to detect mismatches, missing plugins, and naming violations. This skill produces a pass/fail report pinpointing inconsistencies without modifying files.

How do I check for orphan entries in marketplace.json versus plugin directories?

Check for orphan entries by cross-referencing each marketplace.json record against actual plugin directories. This skill identifies marketplace records lacking corresponding plugins and plugins missing marketplace entries.

Why does my plugin version mismatch between marketplace.json and plugin.json?

Version mismatches occur when plugin.json and marketplace.json fields are updated independently. This skill compares version fields across both files and reports discrepancies so maintainers can synchronize them before publishing.

Can I enforce kebab-case naming and required SKILL.md frontmatter across all plugins?

Enforce kebab-case naming and SKILL.md frontmatter by running this validation skill. It checks that every plugin directory contains at least one SKILL.md with required name and description fields and verifies naming conventions.

What is the best way to audit a marketplace repository before publishing updates?

Audit a marketplace repository by running validation checks across metadata files, README catalog entries, and plugin structures. This skill generates a detailed pass/fail report covering version fields, missing skills, and README inaccuracies.

Does this marketplace validation modify any files in the repository?

This marketplace validation does not modify any files. It performs read-only scans across metadata and documentation files, producing a report that maintainers use to manually fix detected inconsistencies.