Skip to content

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. Use skillsaw add plugin to register new plugins automatically.

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).

Codex plugins

This rule covers the Claude marketplace. A directory claimed only by OpenAI Codex — a .codex-plugin/plugin.json, or a local-source listing in a Codex catalog, with no .claude-plugin marker or Claude marketplace listing — is exempt here, but registration is still required: codex-marketplace-registration checks the same obligation against the Codex catalog (.agents/plugins/marketplace.json). A dual-manifest directory keeps this check, and the ecosystem-neutral content and security rules read every plugin's files regardless of provenance.

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.