Skip to content
BENIBIX Learn

plugin.json

AI⌨️ Claude CodeClaude Code Concepts

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

plugin.json is the file that describes a Claude Code plugin. It sits in a hidden folder at the top of the plugin. It holds the plugin's name, version, author and a short description. The name is the only field you must have. Every skill and command in the plugin is grouped under that name. The file itself is optional, because Claude Code can find the parts by their folder names.

Example code

json
{
  "name": "deploy-tools",
  "version": "1.2.0",
  "description": "Deploy commands and a review agent"
}
A name, a version and a short line on what it does.
plugin.json gives the plugin its name. The skills and hooks sit next to it, not inside its folder.

Common mistake

Putting skills or hooks in the same folder as plugin.json. Only that one file goes there. The rest sits at the top of the plugin.

Key takeaways

  1. 1
    Name is required. Use kebab-case.
  2. 2
    Lives in .claude-plugin. Nothing else goes there.
  3. 3
    Version pins users. They stay on it until it changes.

Learn it properly