Skip to content

Fix marketplace sync failure in Claude Desktop/Cowork/web: plugin source points to an invalid plugin directory#12

Open
Tchouk wants to merge 1 commit into
agentskill-sh:mainfrom
NeodeltaEU:main
Open

Fix marketplace sync failure in Claude Desktop/Cowork/web: plugin source points to an invalid plugin directory#12
Tchouk wants to merge 1 commit into
agentskill-sh:mainfrom
NeodeltaEU:main

Conversation

@Tchouk

@Tchouk Tchouk commented Jun 11, 2026

Copy link
Copy Markdown

Problem

Two related issues prevent Claude Desktop / Cowork / claude.ai users from installing the learn plugin as documented at https://agentskill.sh/install (Option 3):

1. The documented URL format isn't accepted by the Desktop/Cowork UI.
The install docs tell Desktop/Cowork users to enter https://agentskill.sh/marketplace.json in the Add marketplace dialog. That dialog only accepts a GitHub owner/repo or a git repository URL (its helper text reads: "A GitHub owner/repo or a git repository URL"), a direct URL to a hosted marketplace.json is not a supported input there. The JSON URL form is only relevant for Claude Code's /plugin marketplace add.

2. The natural fallback, adding the GitHub repo, fails to sync.
Entering agentskill-sh/ags (or the full GitHub URL) fails with:

Marketplace sync failed. Check the repository URL and try again.

So there is currently no working path to install this plugin from Claude Desktop / Cowork.

Root cause of the sync failure

.claude-plugin/marketplace.json declares the plugin with "source": "skills/learn", but that directory is not a valid plugin:

  • it contains no .claude-plugin/plugin.json (the only manifest lives at the repo root)
  • its SKILL.md sits at the directory root instead of under a skills/<name>/ subfolder, so even a lenient loader would discover no skills there

Meanwhile the repo root is a perfectly valid plugin: root-level .claude-plugin/plugin.json (name: learn) plus skills correctly located in skills/learn/ and skills/review-skill/. The marketplace entry just points at the wrong path.

Fix

Point source at the repo root:

-      "source": "skills/learn",
+      "source": "./",

Verified on a fork: with this one-line change, adding the repo via Add marketplace in Claude Desktop syncs correctly and the learn plugin shows up in the directory and installs.

CleanShot 2026-06-11 at 16 20 38

Suggested docs update

Since the website isn't part of this repo, flagging it here: Option 3 at https://agentskill.sh/install should instruct Claude Desktop / Cowork users to enter the GitHub repo (agentskill-sh/ags or https://github.com/agentskill-sh/ags) in Add marketplace, instead of https://agentskill.sh/marketplace.json.

Side effect worth noting

With the plugin root at ./, the installed plugin now bundles both skills (learn and review-skill). If you'd rather ship them as separate plugins, the alternative is giving each skill its own plugin directory with its own plugin.json. Happy to rework the PR that way if you prefer.

replace "source": "skills/learn" by "source": "./"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant