Скиллы и плагины Claude Code: что это и что поставить
Что такое skills и плагины в Claude Code, чем они отличаются от CLAUDE.md и MCP, как ставить плагины через /plugin из официального маркетплейса, как написать свой скилл под бизнес-процесс и чем опасны сторонние плагины.

Claude Code skills — короткие инструкции, которые превращают универсального агента в специалиста по вашему процессу. Плагины — способ поставить готовый набор таких инструкций, проверок и подключений одной командой. Вокруг обоих уже появились каталоги «топ-50 скиллов», и собственник легко попадает в ловушку: ставит всё подряд, агент тормозит и путается, а заодно на компьютере выполняется чужой код. Ниже — что такое скиллы и плагины по официальной документации, как их ставить, как написать свой скилл под бизнес-процесс и что проверить перед установкой чужого.
Коротко:
- Скилл — папка с файлом
SKILL.md: описание и инструкции для конкретной задачи. Claude подгружает его сам, когда задача подходит, или по команде/имя-скилла. - До вызова в контексте лежит только описание скилла, поэтому скиллы экономнее, чем длинный CLAUDE.md.
- Плагин — пакет из скиллов, субагентов, хуков и MCP-серверов. Ставится через
/plugin, официальный маркетплейсclaude-plugins-officialподключается сам. - Плагин выполняет код с вашими правами. Перед установкой читайте, что он добавляет, особенно из сторонних каталогов.
- Самые полезные скиллы для бизнеса — ваши собственные: отчёт, КП, публикация статьи, разбор заявок.
Что такое скиллы в Claude Code
По официальной документации, скилл расширяет возможности Claude: вы создаёте файл SKILL.md с инструкциями, и Claude добавляет его в свой набор инструментов. Использует его, когда это уместно, или когда вы вызываете его напрямую командой /имя-скилла.
Скилл — это папка. В ней обязательный SKILL.md и, при необходимости, вспомогательные файлы: шаблоны, примеры, скрипты. SKILL.md начинается с короткого блока настроек между ---, дальше идут инструкции обычным текстом.
Где лежат скиллы:
| Где | Путь | Для кого |
|---|---|---|
| Личные | ~/.claude/skills/<имя>/SKILL.md | Только вы, во всех проектах |
| Проектные | .claude/skills/<имя>/SKILL.md | Все, кто работает с репозиторием |
| Из плагина | <плагин>/skills/<имя>/SKILL.md | Где плагин включён, вызов /плагин:скилл |
| Корпоративные | Через managed settings | Раздаёт администратор |
Главное свойство — экономия контекста. В обычной сессии в контексте лежит только описание каждого скилла, чтобы Claude знал, что он есть. Полный текст загружается, только когда скилл вызывают. Документация советует держать SKILL.md до 500 строк, а подробности выносить во вспомогательные файлы.
Кстати, бывшие пользовательские слэш-команды (.claude/commands/) теперь объединены со скиллами. Старые файлы продолжают работать, но для новых задач документация рекомендует скиллы. А некоторые скиллы встроены в Claude Code сразу, например /loop для повторяющихся задач и /code-review для проверки кода.
Скилл, CLAUDE.md, плагин, MCP: что для чего
Эти понятия путают чаще всего. Свёл в таблицу.
| Что это | Когда загружается | Пример | |
|---|---|---|---|
| CLAUDE.md | Общие правила проекта | В каждой сессии целиком | «Цены публикуем только на /prices» |
| Скилл | Инструкция для конкретной задачи | Описание всегда, текст — по вызову | «Как готовить еженедельный отчёт» |
| MCP-сервер | Доступ к внешней системе | Инструменты подгружаются по мере нужды | CRM, база данных, трекер |
| Субагент | Отдельный «сотрудник» со своим контекстом | Когда Claude передаёт ему задачу | Проверяющий код, исследователь |
| Плагин | Упаковка всего перечисленного | Пока плагин включён | Набор для отдела маркетинга |
Простое правило: если инструкция нужна всегда — в CLAUDE.md. Если только для одного процесса — в скилл. Это прямой совет из документации: перенос специализированных инструкций из CLAUDE.md в скиллы уменьшает базовый контекст. Как эти слои складываются в окружение для команды, я разбирал в статье про harness.
Что такое плагины и как их ставить
Плагин Claude Code — папка со скиллами, субагентами, хуками, MCP-серверами и другими компонентами, которую Claude Code ставит и загружает как одно целое. Плагины публикуют в маркетплейсах — каталогах со списком плагинов и адресами, откуда их брать.
Официальный маркетплейс Anthropic claude-plugins-official Claude Code добавляет сам при первом запуске в терминале. Чтобы посмотреть, что в нём есть, наберите в сессии:
/plugin
Откроется панель на вкладке Discover. Поставить конкретный плагин можно командой с именем плагина и маркетплейса. Пример из документации — плагин с командами для коммитов и пул-реквестов:
/plugin install commit-commands@claude-plugins-official
Команда не ставит плагин сразу: она открывает карточку, где видно, что именно он добавит (скиллы, агентов, хуки, MCP-серверы), а для официального маркетплейса — ещё и оценку, сколько токенов плагин съест на каждом сообщении. Дальше выбираете область:
- для себя — во всех ваших проектах на этом компьютере;
- для всех в репозитории — включится у каждого, кто работает с проектом;
- только для себя в этом репозитории.
Сторонний маркетплейс сначала добавляют командой /plugin marketplace add с адресом репозитория, потом ставят плагины из него. Отключить плагин, не удаляя, можно в той же панели /plugin.
Что поставить: мой подход
Готового списка «поставьте эти 10 плагинов» я не даю, и вот почему. По документации, включённый плагин участвует в каждой сессии: описания его скиллов и агентов лежат в контексте на каждом сообщении, даже если вы ими не пользуетесь. Это токены и место в контексте. Двадцать плагинов «на всякий случай» — медленнее работа и быстрее лимиты.
Как я подхожу к выбору у клиентов:
- Начать с официального маркетплейса. Смотреть карточку: что ставится и сколько стоит по контексту.
- Ставить под задачу, а не под список. Есть повторяющийся процесс с git — плагин для коммитов. Пишете на типизированном языке — плагин code intelligence: по документации, он даёт точную навигацию по коду вместо поиска по тексту и экономит лишние чтения файлов.
- Раз в месяц чистить. На вкладке Installed есть группа «Not used recently» — плагины, которыми давно не пользовались. Их стоит отключить.
- Главное — свои скиллы. Чужой плагин не знает ваших процессов. Свой скилл знает.
Как написать свой скилл под бизнес-процесс
Возьмём условный пример: менеджеры готовят коммерческие предложения, и каждый делает это по-своему. Задача — чтобы агент собирал КП по единым правилам. Создаём файл .claude/skills/kommercheskoe-predlozhenie/SKILL.md:
---
name: kommercheskoe-predlozhenie
description: Готовит коммерческое предложение по заявке клиента. Используй, когда просят подготовить КП, предложение или расчёт для клиента.
---
# Коммерческое предложение
## Что нужно на входе
- Название компании клиента и контакт
- Что клиент хочет (из заявки или со слов менеджера)
- Объём и сроки, если известны
Если чего-то не хватает — спроси менеджера, не придумывай.
## Как собирать
1. Возьми шаблон из templates/kp.md в этой папке.
2. Услуги и цены бери только из prices/current.md. Не округляй и не давай скидок.
3. Первый абзац — задача клиента его словами, без общих фраз о компании.
4. В конце — один следующий шаг и срок действия предложения: 14 дней.
## Проверка перед выдачей
- Все цены есть в prices/current.md
- Нет обещаний сроков, которых нет в заявке
- Имя клиента написано так же, как в заявке
Что здесь важно:
description— самое главное поле. По нему Claude решает, когда применять скилл. Пишите, что делает скилл и в каких словах его попросят.- Шаблоны и прайс — рядом. Скилл ссылается на файлы в своей папке, они подгружаются только при необходимости.
- Проверка в конце. Агент сверяет результат с правилами до того, как отдать его человеку.
Если скилл должен запускаться только вручную (например, публикация на сайте), в настройки добавляют disable-model-invocation: true — тогда Claude не вызовет его сам, только по команде /kommercheskoe-predlozhenie. Поле allowed-tools перечисляет инструменты, которые скилл может использовать без лишних вопросов.
Такие скиллы — сердце «удочки». Команда пишет их сама под свои процессы, и знания перестают жить в голове одного сотрудника. Как из таких кирпичей собрать полноценного агента, я рассказываю в статье Как создать ИИ-агента для своего бизнеса.
Безопасность сторонних плагинов
Это раздел, который нельзя пропускать. Документация говорит прямо: установленный плагин может выполнять произвольный код на вашем компьютере с вашими правами. Хуки плагина — это команды оболочки, MCP-серверы — процессы на вашей машине. Правила разрешений Claude Code касаются действий самого Claude, а не кода, который плагин запускает сам.
Перед установкой Claude Code показывает предупреждение: Anthropic не контролирует, что входит в плагины, и не может проверить, что они работают как заявлено и не изменятся.
Что я делаю перед установкой чужого плагина:
- Смотрю, чей маркетплейс. Официальные имена (например,
claude-plugins-official) Claude Code принимает только из репозиториевgithub.com/anthropics/. Всё остальное — сторонние каталоги, включая маркетплейс коллеги. - Читаю карточку. Раздел «Will install»: какие хуки, MCP-серверы, скрипты.
- Читаю исходники хуков и MCP. Файлы
hooks/hooks.json,.mcp.jsonи папкуbin/. - Помню про обновления. Если для маркетплейса включено автообновление, файлы плагина могут поменяться после вашей проверки.
Для компаний есть managed settings: администратор разрешает только проверенные маркетплейсы, принудительно включает нужные плагины и ограничивает хуки. В команде больше пяти человек я настраиваю это в первую очередь.
Скиллы в других агентах
Скиллы — не уникальная фишка Claude Code:
- Kimi Code поддерживает skills из своего маркетплейса или любого GitHub-репозитория.
- DeepSeek Harness построен целиком на плагинах: модели, инструменты, skills. Плагины ставятся из менеджера или создаются прямо в чате в режиме Creator mode.
- Codex CLI тоже поддерживает skills.
Поэтому скиллы под процессы компании я пишу так, чтобы они переносились: это просто текст с инструкциями и файлы рядом.
Доступ из России
Anthropic официально не обслуживает Россию — ни приложения, ни API, ни компании, которые базируются в России. Всё про Claude Code в этой статье — для команд с легальным доступом. Для остальных тот же подход со скиллами работает на Kimi Code, DeepSeek Harness или OpenCode с легально доступными моделями. Варианты — в статье Когда режут VPN: на чём работать с ИИ-агентами в России.
Частые вопросы
Чем скилл отличается от плагина? Скилл — одна инструкция для задачи. Плагин — упаковка из скиллов, субагентов, хуков и MCP-серверов, которую ставят одной командой.
Нужно ли программировать, чтобы написать скилл? Нет. Скилл — текстовый файл с описанием и инструкциями. Скрипты внутри можно добавить, но для большинства бизнес-процессов хватает текста и шаблонов.
Сколько скиллов можно держать? Ограничение — контекст: описание каждого скилла, который Claude может вызвать сам, всегда лежит в контексте. Держите описания короткими, а ненужные плагины отключайте.
Безопасно ли ставить плагины из официального маркетплейса? Безопаснее, чем из случайных каталогов, но документация советует проверять любой плагин: он выполняет код с вашими правами.
Работают ли скиллы Claude Code в других агентах? Сам формат — текст и файлы, его легко перенести. Kimi Code, DeepSeek Harness и Codex поддерживают skills, детали формата у каждого свои.
Хотите, чтобы процессы вашей компании жили в скиллах, а не в голове одного сотрудника? Я настраиваю Claude Code или альтернативу, пишу с командой первые скиллы под ваши процессы и учу дальше делать их самим. Напишите в Telegram, какой процесс хотите отдать агенту первым.
Похожие статьи: Harness для ИИ-агента: CLAUDE.md, правила и хуки · Вайбкодинг простыми словами: зачем он собственнику