marketplace-audit

To validate a Claude Code plugin marketplace before commit, run an audit script that checks the marketplace.json structure, verifies file existence, and enforces frontmatter correctness. This process produces a machine-readable report detailing structural integrity and remediation guidance.

Marketplace.json frontmatter validation checks for present and valid frontmatter fields, required structural fields, file existence, semantic versioning, naming conventions, and cross-reference hints. It ensures all referenced agents, skills, and commands exist and adhere to marketplace hygiene standards.

To check for orphaned files in a plugin marketplace, the audit script cross-references the marketplace.json entries against the plugins directory structure. It detects any files residing in the directory that are not referenced in the configuration, ensuring tight structural integrity.

The plugin marketplace audit applies to any project using the standard .claude-plugin/marketplace.json layout and the plugins/<name>/ directory structure. It requires no external dependencies to validate these specific filesystem and configuration layouts.

Marketplace.json validation fails on version semantics when the version strings do not adhere to semantic versioning rules. The audit enforces strict version semantics, naming conventions, and cross-reference checks to prevent inconsistent plugin references from being committed.