⌨️plugin.json
Also known as Claude Code plugin manifest, .claude-plugin/plugin.json, Plugin manifest (Claude Code)
The file that names and describes a Claude Code plugin. Only the name is required.
Think of it like
It is like the label on a box. It gives the name, the version and what is inside.
Example
Lucy names her plugin deploy-tools. Its ship skill then shows up as /deploy-tools:ship in the menu.
Why it matters
The name keeps two plugins with the same skill names apart. The version decides when users get your update.
Definition
Example code
json
{
"name": "deploy-tools",
"version": "1.2.0",
"description": "Deploy commands and a review agent"
}Common mistake
Key takeaways
- 1Name is required. Use kebab-case.
- 2Lives in .claude-plugin. Nothing else goes there.
- 3Version pins users. They stay on it until it changes.