claude-marketplace-registration

Plugins must be registered in marketplace.json

Formerly known as marketplace-registration. The legacy name still works in configs, --rule/--skip-rule, suppression comments, and baselines.

Severity	error (auto)
Autofix	auto
Since	v0.1.0
Repo Types	marketplace
Category	Claude Code

Why

A plugin that exists in the repository but is not registered in marketplace.json is invisible to marketplace tooling — users cannot discover or install it through the standard workflow.

Examples

Bad:

A deploy-plugin/ directory exists but marketplace.json has no entry for it.

Good:

{
  "plugins": [
    {
      "name": "deploy-plugin",
      "path": "deploy-plugin/"
    }
  ]
}

How to fix

Add the plugin to the plugins array in marketplace.json with at least its name and path.

skillsaw fix can append the missing entry, except when the violation is reported without the fixable marker because the file cannot be rewritten safely: marketplace.json is not valid JSON, its root is not an object, plugins is not an array, or the plugin lives outside metadata.pluginRoot (no valid relative source exists — move the plugin under the plugin root or adjust pluginRoot).

Configuration

rules:
  claude-marketplace-registration:
    enabled: auto  # true | false | auto
    severity: error

Run skillsaw explain claude-marketplace-registration to see this documentation and the rule's effective configuration in your terminal.