Багодельня
Справочник Claude Code

Плагины и маркетплейсы

Плагины Claude Code — упаковка skills, сабагентов, хуков и MCP в один пакет, который ставится одной командой. Маркетплейсы для распространения.

Ты собрал полезное: пару skills, сабагента, хуки, настроил MCP. Плагин позволяет упаковать это всё в один пакет и поделиться — чтобы коллега поставил одной командой, а не копировал файлы руками.

Что внутри

Плагин — это папка с манифестом plugin.json и любым набором сущностей:

my-plugin/
├── .claude-plugin/plugin.json   # манифест: имя, версия, автор
├── skills/                      # skills
├── agents/                      # сабагенты
├── hooks/hooks.json             # хуки
└── .mcp.json                    # MCP-серверы

То есть плагин — это контейнер для всего, что мы разобрали в слое «Расширение». Ничего нового он не делает, он переупаковывает уже знакомые сущности для раздачи.

Маркетплейсы

Маркетплейс — это каталог плагинов (часто просто git-репозиторий). Подключаешь маркетплейс — видишь его плагины и ставишь нужные. Бывают официальные и community.

Управление — команда /plugin: подключить маркетплейс, поставить, обновить, удалить плагин.

Плагин не даёт новых возможностей сверх skills / сабагентов / хуков / MCP. Его ценность — дистрибуция: собрать рабочий сетап один раз и разнести по команде или сообществу одной командой.

Как залить плагин в маркетплейс

Маркетплейс — это git-репозиторий с каталогом .claude-plugin/marketplace.json, который перечисляет плагины. Сами плагины могут лежать рядом в этом же репо или ссылаться на чужие.

qa-tools/                                  # git-репозиторий-маркетплейс
├── .claude-plugin/
│   └── marketplace.json                   # каталог: какие плагины внутри
└── plugins/
    └── generate-test-plugin/              # сам плагин
        ├── .claude-plugin/plugin.json
        ├── skills/
        ├── agents/
        └── hooks/hooks.json

В marketplace.json перечисляешь плагины: имя, путь к папке плагина (source) и описание:

.claude-plugin/marketplace.json
{
  "name": "qa-tools",
  "owner": { "name": "Твоя команда" },
  "plugins": [
    {
      "name": "generate-test-plugin",
      "source": "./plugins/generate-test-plugin",
      "description": "Skill /generate-test, сабагенты-сборщики и хуки для авто-генерации e2e."
    }
  ]
}

Дальше — публикация и установка:

# 1. запушь репозиторий-маркетплейс на GitHub/GitLab
git push

# 2. коллега подключает маркетплейс по URL...
/plugin marketplace add https://github.com/team/qa-tools.git

# 3. ...и ставит плагин: <имя-плагина>@<имя-маркетплейса>
/plugin install generate-test-plugin@qa-tools

source может быть и ссылкой на отдельный репозиторий, например { "source": "github", "repo": "team/generate-test-plugin" }. Удобно, когда плагин живёт своей жизнью, а маркетплейс лишь собирает на него ссылку. Добавь плагину version — и обновления поедут к команде через /plugin.

Полная схема манифестов и публикация — в документации по плагинам.

Проверь себя

  1. 1. Что такое плагин?

  2. 2. Даёт ли плагин возможности, которых нет у skills/хуков/MCP по отдельности?

  3. 3. Что такое маркетплейс?

  4. 4. Как опубликовать свой плагин в маркетплейсе?

On this page