Claude Code plugin fails to install: 'agents: Invalid input' in plugin manifest
I tried to install the ECC plugin
everything-claude-code@everything-claude-codein the Claude Code CLI on macOS (Darwin 25.2.0). Installation fails with: 'Failed to install: Plugin has an invalid manifest file at .../.claude-plugin/plugin.json. Validation errors: agents: Invalid input'. What does the manifest schema actually require for theagentsfield, and how can I fix the manifest?Originally asked on GitHub: https://github.com/affaan-m/ECC/issues/90
4 answers
The issue is closed as completed, but no one in the thread confirms that the contributor's recommended fix was actually merged or re-tested, so treat the fix as the maintainer's explanation rather than a verified release.
Root cause (per the contributor's review): the Claude Code plugin manifest validator does not accept directory paths for the
agentsfield at all. It requires explicit file paths to agent files, and it also expects aversionfield to be present in.claude-plugin/plugin.json.Two fixes were discussed. Changing
agentsfrom/.agents/to/agentsstill produced the same validation error. The complete fix is in commitcdf987d: it uses explicit agent file paths instead of directories, convertsagents,commands, andskillsto arrays, and adds the requiredversionfield. The contributor validated this version withclaude plugin validate.General advice for the same error on any Claude Code plugin: inspect
.claude-plugin/plugin.jsonbefore installing and confirmagentspoints to real files rather than a folder,commandsandskillsare arrays, and aversionfield is present.Did this work for you?What @pangerlkr tried on GitHub (Outcome unclear)
A contributor reviewed the failure and recommended commit
cdf987d, which uses explicit agent file paths, convertsagents,commands, andskillsto arrays, and adds theversionfield. They validated it withclaude plugin validate, but no user in the thread confirmed the install succeeded after merging.Source: https://github.com/affaan-m/ECC/issues/90#issuecomment-3803266684 (opens external site)
Did this work for you?What @tobeagency tried on GitHub (Didn't work)
A suggested fix changed the
agentspath from/.agents/to/agentsinplugin.json; the commenter reported the sameagents: Invalid inputvalidation error afterward.Source: https://github.com/affaan-m/ECC/issues/90#issuecomment-3803195607 (opens external site)
Did this work for you?What a GitHub user tried on GitHub (Didn't work)
Ran
/plugin install everything-claude-code@everything-claude-codein the Claude Code CLI on macOS and selected an installation scope; installation failed withagents: Invalid inputin the manifest validation.Source: https://github.com/affaan-m/ECC/issues/90 (opens external site)
Did this work for you?
Related questions
- ECC: plugin marketplace add fails with 'plugins.0.source: Invalid input'
- Claude Code plugin: "Duplicate hooks file detected" error when plugin.json declares standard hooks path
- Why does `npm install opencode-ecc` fail with 'No matching version found'?
- PreToolUse Write hook blocks .claude/plan/*.md in everything-claude-code — fixed?
- ECC with Claude Code: how to install only the skills matching your project?