plugin-json-schema

A plugin.json manifest defines Claude Code plugin configurations, requiring name, version, and description fields. It also supports optional metadata like author, homepage, repository, license, and keywords for comprehensive plugin documentation.

Validate a plugin.json manifest by checking required fields (name, version, description), verifying path formats for standard directories (commands, agents, skills, hooks), and resolving common validation errors outlined in the schema reference.

Auto-discovery automatically loads standard plugin components from designated directories (commands, agents, skills, hooks). Non-standard configurations require explicit declarations in the plugin.json manifest to ensure proper loading.

Yes, non-standard plugin configurations can be defined in plugin.json by explicitly declaring custom paths and components outside the standard auto-discovery directories, ensuring Claude Code loads them correctly.

Plugin.json validation fails when required fields (name, version, description) are missing, path formats are incorrect, or standard directory structures are misconfigured. Review validation errors and ensure fields match the schema reference.

Optional plugin.json metadata includes author, homepage, repository, license, and keywords. These fields enhance plugin discoverability and documentation without affecting core auto-discovery or validation behavior.