How do I install the Marketplace Health skill?

Run npx skillmds@latest add acaprino/marketplace-health in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Marketplace Health safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Marketplace Health?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Marketplace Health free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Marketplace Health?

acaprino (@acaprino) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Marketplace Health by acaprino — Agent Skill

Name: Marketplace Health
Author: acaprino

Marketplace Health

Quick health check for any Claude Code plugin marketplace. TRIGGER WHEN: the user asks to validate marketplace.json, check plugin file references, report plugin counts and version status, or audit structural integrity. DO NOT TRIGGER WHEN: reviewing plugin content quality (use /marketplace-ops:marketplace-review) or authoring new plugins.

acaprino Updated Sep 17, 2026

File contents

Arguments: [--fix] [--verbose]. Wherever <arguments> appears below, substitute the text the user typed after the skill name.

Marketplace Health Check

Run a quick health check on a Claude Code plugin marketplace at the current project root.

Procedure

Read .claude-plugin/marketplace.json
Count plugins, agents, skills, commands
For each plugin, verify that all referenced files/directories exist
Check for orphaned plugin directories not in marketplace.json
Validate metadata.version is present at the root

Output format

Marketplace Health Report
=========================
Name: <marketplace-name>
Version: X.Y.Z
Plugins: N
  Agents: N across M plugins
  Skills: N across M plugins
  Commands: N across M plugins

Issues found: N
  [CRITICAL] ...
  [WARNING] ...

Status: HEALTHY | NEEDS ATTENTION | BROKEN

With --fix flag

Attempt automatic fixes:

Add orphaned plugin directories to marketplace.json with sensible defaults (user confirms each)
Remove references to missing files (user confirms each)
Bump metadata.version after fixes

With --verbose flag

Show per-plugin breakdown with version, category, and asset counts.

Notes

This command is marketplace-agnostic. It works against any project with a standard Claude Code plugin layout.
For the detailed integrity audit (frontmatter validation, naming conventions, color harmony, em-dash detection), use /marketplace-ops:skills-validate or run the audit script directly (python plugins/marketplace-ops/skills/marketplace-audit/scripts/audit_marketplace.py).

---name: marketplace-healthdescription: Quick health check for any Claude Code plugin marketplace. TRIGGER WHEN: the user asks to validate marketplace.json, check plugin file references, report plugin counts and version status, or audit structural integrity. DO NOT TRIGGER WHEN: reviewing plugin content quality (use /marketplace-ops:marketplace-review) or authoring new plugins.---> Arguments: `[--fix] [--verbose]`. Wherever `<arguments>` appears below, substitute the text the user typed after the skill name.# Marketplace Health CheckRun a quick health check on a Claude Code plugin marketplace at the current project root.## Procedure1. Read `.claude-plugin/marketplace.json`2. Count plugins, agents, skills, commands3. For each plugin, verify that all referenced files/directories exist4. Check for orphaned plugin directories not in marketplace.json5. Validate `metadata.version` is present at the root## Output format```Marketplace Health Report=========================Name: <marketplace-name>Version: X.Y.ZPlugins: N Agents: N across M plugins Skills: N across M plugins Commands: N across M pluginsIssues found: N [CRITICAL] ... [WARNING] ...Status: HEALTHY | NEEDS ATTENTION | BROKEN```## With --fix flagAttempt automatic fixes:- Add orphaned plugin directories to marketplace.json with sensible defaults (user confirms each)- Remove references to missing files (user confirms each)- Bump `metadata.version` after fixes## With --verbose flagShow per-plugin breakdown with version, category, and asset counts.## Notes- This command is marketplace-agnostic. It works against any project with a standard Claude Code plugin layout.- For the detailed integrity audit (frontmatter validation, naming conventions, color harmony, em-dash detection), use `/marketplace-ops:skills-validate` or run the audit script directly (`python plugins/marketplace-ops/skills/marketplace-audit/scripts/audit_marketplace.py`).

Frequently asked questions