Claude Code plugin marketplace JSON schema source displayName unsupported
Claude Code marketplace manifests can fail even when the plugin repository is valid. The repair is to match the current marketplace entry shape: remove unsupported display fields and use the accepted source object for the marketplace type.
Agent Quick Fix
Use a minimal marketplace entry with a supported `source` object. Do not include `displayName` if the host schema rejects it.
{
"plugins": [
{
"name": "agent-skills",
"description": "Agent skills for Claude Code",
"source": {
"type": "github",
"repo": "addyosmani/agent-skills"
}
}
]
}Symptom
The marketplace add or install command rejects a marketplace JSON file with errors around `source`, unsupported source formats, or an unrecognized `displayName` field. Upgrading the CLI may not help if the installed CLI already reports latest.
Why This Happens
The moving contract is the Claude Code marketplace parser, not the plugin code itself. A plugin repository can be cloneable and still fail marketplace validation because the manifest uses a stale or undocumented marketplace shape.
Common Wrong Fixes
- Only reinstalling Claude Code.
- Changing the plugin repository while leaving stale marketplace fields.
- Assuming plugin `plugin.json` and marketplace JSON accept the same fields.
Codex Search Keywords
Claude Code plugin marketplace JSON schema source unsupported source format displayName field not recognized
github addyosmani agent-skills .claude-plugin plugin.json
https://raw.githubusercontent.com/addyosmani/agent-skills/main/.claude-plugin/marketplace.json