claude-plugin-devlisted
Install: claude install-skill zhangliang0115/ai-plugin
# Building a Claude Code plugin & marketplace
A Claude Code **plugin** bundles skills, slash commands, subagents, hooks and
MCP servers into one installable unit. A **marketplace** is a git repo that
lists plugins so users can add it by name and install from it with one
command.
## Repo layouts
Single plugin:
```
my-plugin/
├── .claude-plugin/
│ └── plugin.json # {"name": "my-plugin", "version": "1.0.0", "description": "…"}
├── skills/ # <name>/SKILL.md folders
├── commands/ # <command>.md slash commands
├── agents/ # subagent definitions
└── hooks/ # lifecycle hooks
```
Marketplace repo (can list many plugins, including its own subdirectories):
```
my-marketplace/
└── .claude-plugin/
└── marketplace.json
```
```json
{
"name": "my-marketplace",
"owner": { "name": "you" },
"plugins": [
{
"name": "my-plugin",
"source": "./plugins/my-plugin",
"description": "What it does",
"category": "productivity",
"keywords": ["skills", "automation"]
}
]
}
```
A repo can be **both** marketplace and plugin: point the plugin entry at
`"./"` and put a `.claude-plugin/plugin.json` at the repo root (this is the
`zhangliang0115/ai-plugin` pattern).
## How users install
```sh
# inside Claude Code:
/plugin marketplace add you/my-marketplace # git URL or owner/repo
/plugin install my-plugin@my-marketplace
```
Skills can also be dropped straight into `~/.claude/skill