Skip to content

netlify-skills plugin manifest conflicts with marketplace entry, plus netlify-db/netlify-database name mismatch #27

@AliSahlolbei

Description

@AliSahlolbei

Problem

Installing netlify-skills from the netlify-context-and-tools marketplace produces a warning under /doctor in Claude Code:

Plugin netlify-skills has conflicting manifests: both plugin.json and marketplace entry specify components. Set strict: true in marketplace entry or remove component specs from one location.

Root cause

In .claude-plugin/marketplace.json, the netlify-skills entry explicitly lists 13 skills under "skills": [...]. The plugin source directory also contains a skills/ folder with those same skills, which Claude Code auto-discovers as implicit components. Both sources declaring components is what triggers the warning.

Secondary bug

The marketplace entry references:

"./skills/netlify-db",

…but the actual folder is named netlify-database. With strict: false (current setting) the warning is the only symptom because auto-discovery picks up the real folder. If anyone flips strict: true to silence the warning, the netlify-db entry will fail to resolve and that skill will silently not load.

Suggested fix

Drop the explicit skills array from the marketplace entry and let folder-based auto-discovery be the single source of truth:

{
  "name": "netlify-skills",
  "description": "...",
  "source": "./"
}

That removes the conflict and sidesteps the netlify-db/netlify-database mismatch in one go. (Alternative: keep the array but fix the typo and set strict: true — works, but is more brittle to future skill additions.)

Repro

  1. /plugin marketplace add netlify/context-and-tools
  2. /plugin install netlify-skills@netlify-context-and-tools
  3. /reload-plugins
  4. /doctor → warning appears

Environment

  • Claude Code on macOS
  • netlify-skills v1.1.0
  • Plugin loads successfully (13 skills); this is a warning, not a hard failure

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions