skills.rest
lucasilverentand
lucasilverentandCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

managing-marketplace

Validate Claude Code marketplace.json structure and skill paths.

3|Updated Jan 23, 2026
Search Tags:#validation#plugins#marketplace#frontmatter#CI#health-report
One-click install
npx skills add https://github.com/lucasilverentand/skills --skill managing-marketplace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: managing-marketplace
Source: https://github.com/lucasilverentand/skills/tree/main/skills/tooling/managing-marketplace
Command: npx skills add https://github.com/lucasilverentand/skills --skill managing-marketplace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill validates and maintains Claude Code plugin marketplace health by ensuring marketplace.json accuracy, verifying skill paths, and generating comprehensive health reports for CI and audits.

Core Features & Use Cases

  • Validate marketplace.json structure and required fields
  • Verify that each skill path points to an existing SKILL.md and validates its frontmatter
  • Identify orphan skills on disk and propose fixes to marketplace.json
  • Generate health reports for CI pipelines and marketplace audits
  • Use Case: Run marketplace health checks before a release to ensure all plugins are correctly referenced

Quick Start

Run a quick validation against your marketplace configuration:

  • Validate: python3 ${CLAUDE_PLUGIN_ROOT}/skills/tooling/managing-marketplace/scripts/verify-marketplace.py .claude-plugin/marketplace.json
  • If you want to auto-fix: python3 ${CLAUDE_PLUGIN_ROOT}/skills/tooling/managing-marketplace/scripts/verify-marketplace.py --fix .claude-plugin/marketplace.json

Frequently Asked Questions about managing-marketplace

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

FAQPage Schema
How do I validate marketplace.json structure and required fields for Claude Code plugins?▼

You can validate marketplace.json structure by running the verify-marketplace.py script against your configuration file, which checks required fields, frontmatter validity, naming conventions, and verifies that each skill path points to an existing SKILL.md.

What's the best way to find orphan skills on disk that aren't referenced in marketplace.json?▼

The best way to find orphan skills is to run the marketplace validation script, which identifies orphan SKILL.md entries on disk that are missing from marketplace.json and proposes fixes to update the references.

Can I generate a health report for Claude Code marketplace plugins in a CI pipeline?▼

Yes, you can generate a health report for CI pipelines by running the validation script, which audits marketplace.json integrity, verifies skill paths, and outputs findings suitable for continuous integration checks.

Do I need any dependencies installed to run marketplace validation and health checks?▼

No external dependencies are required to run marketplace validation and health checks, as the Skill operates standalone using Python scripts to verify marketplace.json integrity and frontmatter validity.

Why does marketplace validation report show missing SKILL.md files for referenced plugins?▼

Marketplace validation reports missing SKILL.md files when marketplace.json contains skill paths that do not exist on disk, indicating broken references that need to be corrected or removed from the configuration.

How do I auto-fix orphan skills and broken references in marketplace.json?▼

To auto-fix orphan skills and broken references, run the verify-marketplace.py script with the --fix flag, which automatically updates marketplace.json to resolve missing paths and align entries with existing SKILL.md files.

Related Skills

Explore More Software Engineering Skills→
mattbobambrosemattbobambrose
1

rename-plugin

Rename plugins across marketplace files and update catalog entries.

Community
Intermediate
pradyumnasagarpradyumnasagar
6

release-management

Manages ORS skill releases with versioning, changelogs, and marketplace updates.

Community
Intermediate
mattbobambrosemattbobambrose
1

validate-marketplace

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

Community
Intermediate
tonone-aitonone-ai
69

flux-health

Detect data quality issues and pipeline health across databases and warehouses.

Official
Intermediate