Плагины и skills ИИ-агента: как расширить агента под свою команду

Один и тот же кодинг-агент у двух команд решает разные задачи по-разному — не потому, что модель другая, а потому что у него разные расширения. Кто-то научил Claude Code ходить в ваш трекер и запускать тесты одной командой, кто-то подключил корпоративный MCP-сервер, а кто-то посадил агента на 40 плагинов и удивляется, почему он стал тормозить и путаться. Ниже — как устроены расширения ходового кодинг-агента, чем skill отличается от плагина и MCP, как написать свой skill с нуля и как не утопить контекст. Всё сверено по официальной документации Claude Code, Cursor, Codex и OpenCode на 10.09.2026.

Термины: что чем называется

Главная путаница — люди называют «плагином» всё подряд. В документации Claude Code это четыре разных сущности с разным назначением.

Правило выбора простое. Нужен внешний инструмент или данные — MCP. Надо научить агента повторяемому процессу — skill. Надо сложить несколько возможностей и отдать команде — плагин. В документации Claude Code есть отдельная таблица, которая прямо противопоставляет «standalone-конфигурацию в .claude/» (для быстрых личных экспериментов) и «плагин» (для распространения и версий).

Важная деталь: по документации Claude Code навыки следуют открытому стандарту Agent Skills, который работает в нескольких ИИ-инструментах, а сам Claude Code добавляет поверх него управление вызовом и субагентов. То есть структура SKILL.md — не вещь в себе, а переносимый формат.

Готовые расширения: как поставить

У Claude Code установка двухшаговая — сначала подключается «магазин», потом ставится плагин. Официальный маркетплейс Anthropic регистрируется автоматически при первом запуске, но если он не подключился (например, сеть заблокировала загрузку), добавить можно вручную:

# 1. добавить маркетплейс (официальный или сторонний)
/plugin marketplace add anthropics/claude-plugins-official

# 2. поставить конкретный плагин из него
/plugin install github@claude-plugins-official

# в неинтерактивном режиме: та же установка через CLI, со scope
claude plugin install formatter@your-org --scope project

Команда /plugin открывает интерактивную панель с вкладками; в ней есть Discover (что подключено), Installed (что стоит) и Stats — по документации последняя показывает, сколько контекста стоит каждый ваш скилл и как часто он вызывается. Scope установки бывает user (все проекты), project (для команды в репозитории) и local (только у вас в этом проекте).

В Codex установка выглядит иначе: по документации Codex плагины упаковывают скиллы, MCP-серверы и хуки, а в CLI браузер плагинов открывается командой /plugins — оттуда ставят плагин из настроенного маркетплейса и стартуют новую сессию, чтобы подхватились его скиллы и инструменты. В IDE-расширении плагины не поддерживаются.

В OpenCode плагины — это JS/TS-файлы: их кладут в .opencode/plugins/ (проект) или ~/.config/opencode/plugins/ (глобально), и они подгружаются автоматически при старте; npm-пакеты прописываются в opencode.json в списке plugin и тянутся автоматически через Bun, по докам OpenCode.

Свой skill с нуля

Skill — это каталог и один файл SKILL.md внутри него. Согласно документации Claude Code, у файла две части: YAML-фронтматтер (когда применять) и markdown-тело (что делать). Имя каталога становится именем команды: каталог summarize-changes даёт /summarize-changes.

Фронтматтер разбирается только тогда, когда открывающая строка --- стоит первой строкой файла. Все поля опциональны, но именно description решает, вызовет ли агент skill сам.

---
name: changelog-entry
description: Пишет запись в CHANGELOG из коммитов ветки. Используй, когда просят обновить changelog или подвести итог изменений перед релизом.
---

## Изменения ветки

!`git log --oneline main..HEAD`

## Инструкции

1. Сгруппируй коммиты по типу: добавлено, исправлено, изменено.
2. Опиши каждое изменение одной строкой на русском, без внутреннего жаргона.
3. Не упоминай служебные коммиты (merge, revert пустых правок).
4. Верни готовый markdown-блок для вставки в CHANGELOG.md.

Ключевая механика — тело skill загружается только при использовании. Это его главное отличие от файла конвенций вроде AGENTS.md: длинную справку можно держать в skill и не платить за неё токенами до момента вызова. Строка !`команда во фрагменте выше — динамическая подстановка: перед отправкой в модель команда выполняется, и её вывод вставляется на место. Так агент получает свежий git diff или лог, не запуская отдельный шаг.

Как поделиться с командой

Три уровня распространения, от частного к общему:

1. Каталог .claude/skills/ в репозитории. Skill уезжает в git вместе с кодом и доступен всем, кто клонирует проект. Подходит для правил, завязанных на конкретный репозиторий.
2. Домашний каталог ~/.claude/skills/. Личный набор, доступный во всех ваших проектах. Удобно для личных привычек, но коллегам не помогает.
3. Плагин. Каталог с .claude-plugin/plugin.json в корне упаковывает скиллы, субагентов и хуки в одно целое. Skills плагина живут в отдельном пространстве имён — /plugin-name:skill-name, поэтому плагин не перетирает одноимённый локальный skill. По русскоязычной странице документации плагин из маркетплейса ставится и обновляется без ручного копирования файлов.

Структура минимального плагина из официальной доки:

code-review-plugin/
├── .claude-plugin/
│   └── plugin.json          # манифест плагина
└── skills/
    └── code-review/
        └── SKILL.md          # сам skill

Маркетплейс для публикации — это просто git-репозиторий с файлом-каталогом; по документации по маркетплейсам его хостит GitHub/GitLab, а пользователи подключают командой /plugin marketplace add и обновляют через /plugin marketplace update. Отдельного биллинга или бэкенда у этой схемы нет.

Безопасность расширений

Плагин — это чужой код рядом с вашим репозиторием, и относиться к нему надо соответственно.

• Хуки выполняют shell-команды. Плагин может приложить хук, который запускается на событиях агента автоматически. Пока вы читаете описание плагина, хук уже имеет право выполнить rm или curl. Читайте содержимое hooks до установки.
• MCP-серверы получают доступ к внешним системам. Плагин подключает сервер, у которого есть ваши токены к GitHub, трекеру или базе. Что именно отдаёт и делает такой сервер — разбирает обзор Что такое MCP, а список проверенных серверов собраны в подборке Лучшие MCP-серверы.
• Тестируйте изолированно. Плагин можно подключить без установки флагом claude --plugin-dir ./my-plugin — он загрузится только на эту сессию. Это дешёвый способ посмотреть, что плагин делает, до того как он пропишется в настройках.
• Не тяните секреты в контекст. Токены держите в окружении или .env, а не в тексте skill.

Почему «много плагинов» = плохо

Каждый расширение добавляет к сессии свой вклад в контекст и старт. Документация Claude Code прямо описывает механизм борьбы с этим: плагины, которые вы поставили сами и не вызывали минимум две недели в течение хотя бы 10 сессий, попадают в раздел Not used recently с датой последнего использования — чтобы «найти плагины, которые всё ещё добавляют стоимость старта и контекста, хотя вы их больше не используете». Оттуда их можно выключить или удалить.

Практический эффект от перегруза — тоже документированное явление: чем больше инструментов у агента, тем чаще он выбирает не тот и тем дороже каждый ход. Механику контекста агента разбирает отдельная статья Контекст ИИ-агента, а про то, как изолировать тяжёлые задачи через субагентов, — Mentions и субагенты в Claude Code. Практика: держите включённым минимум, остальное приносите по мере надобности. В OpenCode для этого есть package.json и Load order в самих плагинах, в Claude Code — scope и отключение.

Российские реалии

• Маркетплейсы и каталоги плагинов. Официальный маркетплейс Anthropic и сама установка npx/git clone из GitHub из РФ в целом доступны без VPN, но часть CDN блокирует российские IP, а сам агент без VPN может не авторизоваться. Сторонние каталоги скиллов (например, skills.sh) ставятся через npx из npm — npm из РФ работает.
• Оплата. Подписка Claude Pro/Max и API Anthropic российскими Visa/Mastercard не оплачиваются: нужны виртуальные зарубежные карты (пополнение через СБП или USDT), карты банков Казахстана/Грузии/Армении либо посредники с наценкой. Риск бана аккаунта за карту не из региона сохраняется.
• Риск чужого плагина. Плагин ставится из произвольного git-репозитория и исполняет хуки. В сообществе это отдельная тема: разбор «что именно исполняет плагин» и подписей расширений — в публикации про то, как устроены плагины и расширения Cursor.
• Русскоязычная фактура. Пошаговый разбор структуры «skill → plugin → marketplace» и сборки своего маркетплейса — на Habr, «Как делать скилы правильно и собрать из них маркетплейс»; контекст выхода Claude Code Plugins в гонке экосистем — в новости Habr; практические заметки по установке и scope — у matveev.tech.

Ограничения

• Agent Skills как стандарт молод. Формат SKILL.md переносим между инструментами, но расширения сверх стандарта (управление вызовом, субагенты) у каждого агента свои — skill из Claude Code не обязательно заработает в Codex один в один.
• Cursor-документация рендерится на клиенте. Часть страниц расширений доступна только в браузере; точные имена полей и путей стоит сверять в самой студии, а не в пересказе.
• Плагины Codex не работают в IDE-расширении — только в CLI (браузер /plugins) и в приложении ChatGPT для рабочего стола.
• Хуки не песочница. Изоляция флагом --plugin-dir защищает от записи в настройки, но не от того, что хук плагина выполнит команду в вашем окружении.
• Стоимость контекста не видна заранее. Сколько токенов съест конкретный скилл, показывают Stats//skill-doctor; до установки это оценить нельзя.
• Версии. Всё описанное — на момент публикации 10.09.2026; имена команд и структура каталогов в этой экосистеме меняются быстро, перед использованием сверяйтесь с актуальной докой (/plugin marketplace add, claude plugin install, /plugins в Codex).

Связанные статьи

• Cursor Plugins и расширения — как устроены плагины у Cursor
• Как установить Claude Code — установка и первый запуск агента
• Что такое MCP — протокол внешних инструментов
• Mentions и субагенты в Claude Code — изоляция задач

Читайте также: Настройка ИИ-агента под свой проект: чек-лист из 10 шагов · Claude Code vs Codex: что выбрать в сентябре 2026