Plugin installation fails: Invalid manifest file - agents field validation error

[jhsong-musinsa]

Bug Report

Description

The plugin fails to install due to an invalid manifest file. The agents field in plugin.json does not pass validation.

Error Message

Error: Failed to install: Plugin has an invalid manifest file at
/Users/gaemi/.claude/plugins/cache/temp_local_1769486831744_00ksfi/.claude-plugin/plugin.json.
Validation errors: agents: Invalid input

Steps to Reproduce

1. Run /plugin install everything-claude-code@everything-claude-code in Claude Code CLI
2. Select any installation scope
3. Installation fails with the above error

Expected Behavior

The plugin should install successfully.

Environment

• Platform: macOS (Darwin 25.2.0)
• Claude Code CLI

Suggested Fix

Please review and fix the agents field in .claude-plugin/plugin.json to comply with the Claude Code plugin manifest schema.

[jonathangerbaud]

Same here. Wanted to test it but it doesn't work....

[tobeagency]

Same - also showing same for suggested fix (change agents from /.agents/ to /agents in plugin.json)

[chung-sk]

same error here, just tested.

[pangerlkr]

I reviewed the validation failure and the linked fixes carefully.

The root cause is not just that agents must be an array, but that the Claude plugin manifest validator does not accept directory paths for agents at all. It requires explicit file paths, and it also expects a version field to be present.

The first fix (array of directories) improves correctness but is still insufficient and will continue to fail validation in some environments.

The second commit (cdf987d) is the correct and complete solution:

• Uses explicit agent file paths, not directories
• Converts agents, commands, and skills to arrays as required
• Adds the required version field
• Has been validated with claude plugin validate

This aligns with known working plugins and fully satisfies the manifest schema.

Recommendation: merge the commit with explicit file paths (cdf987d) and that should resolve installation failures for everyone consistently.