# plugin.json

> The file that names and describes a Claude Code plugin. Only the name is required.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Claude Code plugin manifest, .claude-plugin/plugin.json, Plugin manifest (Claude Code)

## Think of it like

It is like the label on a box. It gives the name, the version and what is inside.

## 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

Lucy names her plugin deploy-tools. Its ship skill then shows up as /deploy-tools:ship in the menu.

## 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.

## Why it matters

The name keeps two plugins with the same skill names apart. The version decides when users get your update.

## 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.

## Three principles

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

## Related terms

- [Claude Code Plugin](https://learn.benibix.com/term/ai/claude-code-plugin)
- [Plugin Marketplace](https://learn.benibix.com/term/ai/plugin-marketplace)
- [claude plugin validate Command](https://learn.benibix.com/term/ai/claude-plugin-validate-command)
- [CLAUDE_PLUGIN_ROOT](https://learn.benibix.com/term/ai/claude-plugin-root-variable)
- [JavaScript Object Notation (JSON)](https://learn.benibix.com/term/development/json)

## Taught in

- [Skills, Plugins and Styles](https://learn.benibix.com/learn/ai-claude-code/skills-plugins-and-styles): Claude Code, 14/16

![Three files side by side, each with a header between two lines of dashes. A subagent file in .claude/agents with name, description, tools and model. A SKILL.md with description and allowed-tools. A plugin.json in .claude-plugin with name, version and description.](https://learn.benibix.com/diagrams/ai8-cc-extension-files.svg)

---

Source: https://learn.benibix.com/term/ai/plugin-json
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
