К содержанию
Все статьи

Скиллы и плагины Claude Code: что это и что поставить

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

🧑‍💻Сергей Шульман 8 мин чтения

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 плагинов» я не даю, и вот почему. По документации, включённый плагин участвует в каждой сессии: описания его скиллов и агентов лежат в контексте на каждом сообщении, даже если вы ими не пользуетесь. Это токены и место в контексте. Двадцать плагинов «на всякий случай» — медленнее работа и быстрее лимиты.

Как я подхожу к выбору у клиентов:

  1. Начать с официального маркетплейса. Смотреть карточку: что ставится и сколько стоит по контексту.
  2. Ставить под задачу, а не под список. Есть повторяющийся процесс с git — плагин для коммитов. Пишете на типизированном языке — плагин code intelligence: по документации, он даёт точную навигацию по коду вместо поиска по тексту и экономит лишние чтения файлов.
  3. Раз в месяц чистить. На вкладке Installed есть группа «Not used recently» — плагины, которыми давно не пользовались. Их стоит отключить.
  4. Главное — свои скиллы. Чужой плагин не знает ваших процессов. Свой скилл знает.

Как написать свой скилл под бизнес-процесс

Возьмём условный пример: менеджеры готовят коммерческие предложения, и каждый делает это по-своему. Задача — чтобы агент собирал КП по единым правилам. Создаём файл .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 не контролирует, что входит в плагины, и не может проверить, что они работают как заявлено и не изменятся.

Что я делаю перед установкой чужого плагина:

  1. Смотрю, чей маркетплейс. Официальные имена (например, claude-plugins-official) Claude Code принимает только из репозиториев github.com/anthropics/. Всё остальное — сторонние каталоги, включая маркетплейс коллеги.
  2. Читаю карточку. Раздел «Will install»: какие хуки, MCP-серверы, скрипты.
  3. Читаю исходники хуков и MCP. Файлы hooks/hooks.json, .mcp.json и папку bin/.
  4. Помню про обновления. Если для маркетплейса включено автообновление, файлы плагина могут поменяться после вашей проверки.

Для компаний есть 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, правила и хуки · Вайбкодинг простыми словами: зачем он собственнику

Читайте также

Есть похожая задача?

Разберу её бесплатно за 30 минут и предложу решение. Пишите в Telegram или звоните.