# Плагины и Marketplace

> Плагины расширяют Kodik навыками, командами, правилами, хуками, профилями субагентов и MCP-серверами, устанавливаемыми через встроенный Marketplace.

Источник: https://docs.kodik.ru/customization/plugins

Плагины — это пакеты расширений для Kodik. Они могут добавлять skills, слеш-команды, правила поведения агента, хуки жизненного цикла, профили субагентов и MCP-серверы. Устанавливать плагины и находить новые можно через встроенный Marketplace.

## Открытие Marketplace

Откройте Marketplace командой Ctrl+Shift+X или из Командной палитры (Ctrl+Shift+P → «Kodik: Open Marketplace»). В Marketplace можно искать плагины, просматривать описания и устанавливать их в один клик.

## Что могут предоставлять плагины

Плагин может включать любую комбинацию следующих компонентов:

| Компонент              | Описание                                                     | Подробнее                                              |
| ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------ |
| **Skills**             | Специализированные рабочие процессы и компетенции для агента | [Skills](https://docs.kodik.ru/customization/skills)                        |
| **Слеш-команды**       | Пользовательские команды, вызываемые через `/` в чате        | [Слеш-команды](https://docs.kodik.ru/customization/slash-commands/overview) |
| **Правила**            | Файлы правил, управляющие поведением агента в рамках проекта | [Правила](https://docs.kodik.ru/context/rules)                              |
| **Хуки**               | Shell-команды, привязанные к событиям жизненного цикла       | [Хуки](https://docs.kodik.ru/customization/hooks)                           |
| **Профили субагентов** | Определения специализированных субагентов                    | [Субагенты](https://docs.kodik.ru/agent/subagents)                          |
| **MCP-серверы**        | Дополнительные инструменты и ресурсы через протокол MCP      | [MCP](https://docs.kodik.ru/mcp/overview)                                   |

## Пространство имён

Все компоненты, поставляемые плагинами, автоматически получают пространство имён по идентификатору плагина:

- Skill `my-workflow` из плагина `acme` виден как `acme:my-workflow`.
- Команда `deploy` из плагина `acme` вызывается как `/acme:deploy` (также доступна как `/deploy`).

Это позволяет нескольким плагинам предоставлять компоненты с одинаковыми именами без конфликтов.

## Включение и отключение плагинов

После установки плагин включён по умолчанию. Вы можете отключить его через настройки плагина в Marketplace или в разделе настроек Kodik. Отключённый плагин не вносит никаких компонентов в сессию агента, пока снова не будет включён.

Для MCP-серверов это означает, что записи из `.mcp.json` плагина исчезают из настроек и из списка инструментов агента, пока плагин отключён. Отдельные пользовательские и проектные MCP-серверы при этом не затрагиваются.

MCP-серверы, поставляемые плагином, принадлежат пакету плагина. В настройках используйте **Uninstall plugin**, чтобы удалить их вместе с плагином; отдельные MCP-серверы плагина не удаляются через обычные элементы управления MCP-серверами.

Удаление плагина удаляет установленные файлы и очищает сохранённую в Kodik политику этого плагина. Секретные значения конфигурации плагина, например защищённые поля MCP user config, сохранённые в secure storage, также удаляются.

## Структура плагина на диске

Установленные плагины располагаются в глобальной директории плагинов Kodik. Каждый плагин занимает отдельную поддиректорию с манифестом `.kodik-plugin/plugin.json`. Компоненты плагина хранятся в стандартных поддиректориях:

```
<plugin-id>/
  .kodik-plugin/
    plugin.json          # манифест плагина
  .mcp.json              # конфигурации MCP-серверов
  skills/<skill-dir>/    # skills (каждый в своей директории)
  commands/<cmd>.md      # слеш-команды
  rules/<rule>.md        # правила
  agents/<agent>.md      # профили субагентов
  hooks/hooks.json       # хуки
```

## Связанные разделы

- [Skills](https://docs.kodik.ru/customization/skills) — создание и использование skills
- [Хуки](https://docs.kodik.ru/customization/hooks) — хуки жизненного цикла
- [MCP](https://docs.kodik.ru/mcp/overview) — протокол MCP и серверы
- [Субагенты](https://docs.kodik.ru/agent/subagents) — специализированные субагенты