Edemiumвнедрение ИИ Довести до прода
ГлавнаяУслугиКейсы
  1. Главная
  2. Вайбкодинг
  3. Claude Code skills, хуки и MCP

Вайбкодинг · продвинутым

Claude Code skills, хуки и MCP: как научить агента работать по-вашему

Пять способов настроить агента — от скиллов до плагинов — с готовыми шаблонами, которые можно скопировать, и нашим опытом на десятках проектов.

Владислав Терещенко, основатель EdemiumОбновлено 20 ноября 202611 минут чтения
2 раза

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

01 · Обзор

Как расширить Claude Code: скиллы, субагенты, хуки, MCP и плагины

Как расширить Claude Code: скиллы, субагенты, хуки, MCP и плагины

Claude Code настраивается пятью способами: скиллы дают знания, субагенты — помощников, хуки — автоматические правила, MCP — доступ к внешним сервисам, плагины упаковывают всё это для установки одной командой.

знания

Скиллы

Папка с инструкцией и файлами: «как у нас делают документы», «как выкатывать сайт». Агент подгружает её, только когда задача подходит.

помощники

Субагенты

Отдельные агенты со своей ролью и моделью: «ревьюер кода», «исследователь». Работают параллельно и не засоряют основной разговор.

автоматика

Хуки

Команды, которые запускаются сами на события: перед правкой файла, после неё, когда агент закончил. Не просьба, а правило.

руки

MCP

Подключение внешних сервисов: браузер, документация библиотек, база данных, GitHub, почта.

упаковка

Плагины

Набор из скиллов, команд, субагентов, хуков и MCP одним пакетом — чтобы поставить себе или команде одной командой.

Новичку не нужно всё сразу. Порядок, который окупается: сначала файл памяти CLAUDE.md, потом один-два MCP (документация и браузер), потом скиллы под повторяющиеся задачи, и только потом хуки.

02 · Знания

Claude Code skills: что это и как сделать свой скилл

Claude Code skills: что это и как сделать свой скилл

Скилл — папка с файлом SKILL.md: в шапке название и описание, когда его использовать, ниже — инструкция. Агент держит в памяти только описание и подгружает скилл целиком, когда задача подходит. Поэтому скиллов может быть много без лишнего расхода токенов.

Простой скилл — файл ~/.claude/skills/deploy/SKILL.md
---
name: deploy
description: Выкатка сайта на сервер. Используй, когда просят выкатить, задеплоить или обновить сайт.
---

# Выкатка
1. Проверь, что нет незакоммиченных изменений и секретов в коде.
2. Запусти тесты: npm test. Упали — остановись и покажи ошибку.
3. git push, затем на сервере: deploy my-site.
4. Открой сайт и проверь главную и форму заявки.
5. Напиши коротко: что выкатили и что проверил.

Главное в скилле — строка description: по ней агент решает, когда подгрузить инструкцию. Пишите в ней, на какие слова пользователя реагировать.

Скиллы лежат в ~/.claude/skills/ (для всех ваших проектов) или в .claude/skills/ внутри проекта (для команды, попадают в git). Рядом с SKILL.md можно положить скрипты, шаблоны и примеры — агент возьмёт их, когда понадобится.

Где брать готовые: каталог skills.sh (ставятся командой npx skills add) и репозитории на GitHub. Перед установкой читайте SKILL.md — это инструкция, которую агент будет выполнять, и в ней может быть что угодно.

«Как у нас оформлять документы»

Скилл: правила оформления + шаблон + скрипт сборки.

«Как выкатывать сайт»

Скилл: шаги, проверки, что делать при ошибке.

«Как писать статьи для блога»

Скилл: структура, тон, запреты, примеры удачных статей.

«Как работать с таблицами клиента»

Скилл: где лежат, какие колонки, что нельзя трогать.

03 · Помощники

Субагенты: команда внутри Claude Code

Субагенты: команда внутри Claude Code

Субагент — отдельный агент со своей ролью, инструкцией и моделью. Основной агент поручает ему часть работы, получает короткий итог и не засоряет свою память деталями.

Субагенты описываются файлами в .claude/agents/. Типичные роли:

  • Исследователь — ищет по большому проекту и возвращает только выводы.
  • Ревьюер — смотрит изменения свежим взглядом и ищет ошибки.
  • Тестировщик — запускает проверки и разбирает падения.

Главная экономия — в выборе модели: рутинному субагенту, который просто читает файлы, не нужна самая дорогая модель. Укажите в его настройках быструю и дешёвую — и лимит подписки проживёт заметно дольше. Подробно про экономию — в статье «Токены Claude Code».

04 · Правила

Хуки Claude Code: правила, которые агент не может нарушить

Хуки Claude Code: правила, которые агент не может нарушить

Хук — команда, которую Claude Code запускает сам на определённое событие: перед действием, после правки, по окончании работы. Просьбу в CLAUDE.md агент может забыть, хук сработает всегда.

Хук: не отпускать агента, пока не прошли тесты — фрагмент .claude/settings.json
{
  "hooks": {
    "Stop": [
      { "hooks": [
        { "type": "command",
          "command": "npm test >&2 || exit 2" }
      ] }
    ]
  }
}

Когда агент решил, что закончил, запускаются тесты. Если упали — код выхода 2 возвращает агента к работе и передаёт ему текст ошибки.

Из свежего · почему именно exit 2

Частая ошибка при настройке хуков: скрипт падает с кодом 1, и ничего не происходит. В Claude Code блокирует только код выхода 2: текст из потока ошибок передаётся агенту, и он возвращается к задаче. Код 1 считается неблокирующей ошибкой, и агент спокойно идёт дальше. Отсюда конструкция команда >&2 || exit 2.

Что ещё делают хуками: запрещают правку файлов с ключами, автоматически форматируют код после каждой правки, присылают уведомление, когда агент закончил долгую задачу. Осторожно с хуком на окончание: если тест не может пройти в принципе, агент будет крутиться по кругу — следите за первыми запусками.

05 · Сервисы

MCP в Claude Code: как подключить внешние сервисы

MCP в Claude Code: как подключить внешние сервисы

MCP — открытый стандарт, по которому агент подключается к внешним сервисам: браузеру, документации, базе данных, GitHub, почте. Подключается одной командой claude mcp add.

Два MCP, которые мы ставим почти всегда
# свежая документация библиотек вместо устаревших знаний модели
claude mcp add --transport http context7 https://mcp.context7.com/mcp

# браузер: агент сам открывает страницу, кликает и делает снимки
claude mcp add playwright npx @playwright/mcp@latest

Посмотреть, что подключено: claude mcp list. Каждый MCP — это доступ: ставьте только из официальных источников.

Почему документация через MCP так важна: знания модели заканчиваются на дате обучения, а библиотеки обновляются каждый месяц. Без свежей документации агент уверенно пишет код под старую версию, и он не запускается. Мы подключаем такой сервер во всех проектах.

Браузер через MCP закрывает вторую боль — «агент сказал готово, а страница сломана»: агент сам открывает страницу, смотрит на неё и исправляет.

MCP, которые чаще всего полезны вайбкодеру
  • Документация библиотек — чтобы код писался под актуальные версии.
  • Браузер — чтобы агент сам проверял страницы.
  • База данных (например, Supabase) — смотреть структуру и данные; на рабочей базе — только чтение.
  • GitHub — задачи, ветки, проверки кода.
  • Почта и календарь — если агент помогает с рутиной, а не только с кодом.

Хотите в команду, где всё это уже настроено? Дадим постоянные заказы.

Хочу в команду

06 · Не из новостей

Как мы собираем свой набор скиллов

Как мы собираем свой набор скиллов

Держите скиллы и общие правила в одном месте и переиспользуйте во всех проектах. Мы храним глобальные правила и скиллы отдельно от проектов, а в проекте — только то, что касается его.

Что у нас в общем наборе: правила общения и стиля, выкатка на сервер одной командой, проверка на секреты перед отправкой кода, оформление документов, генерация картинок, работа с поисковыми данными. Каждый новый проект сразу получает этот опыт.

Из свежего · паттерн «домашний репозиторий»

Преподаватель Мэтт Покок описал похожий подход: один «домашний» репозиторий со скиллами и инструкциями, из которого агент работает со всеми остальными проектами. Плюс в том, что улучшение скилла сразу действует везде, а опыт не размазан по десяткам папок.

Правило, которое мы вывели на десятках проектов: если объяснили агенту одно и то же дважды — это кандидат в скилл. Если агент дважды наступил на одни грабли — кандидат в хук.

07 · Вопросы

Частые вопросы о скиллах, хуках и MCP

Что такое skills в Claude Code?

Это папки с инструкцией SKILL.md и вспомогательными файлами. Агент держит в памяти только их описание и подгружает скилл целиком, когда задача подходит.

Где хранить скиллы Claude Code?

В ~/.claude/skills/ — для всех проектов, или в .claude/skills/ внутри проекта — для команды.

Чем скилл отличается от CLAUDE.md?

CLAUDE.md читается всегда, поэтому в нём только главное о проекте. Скилл подгружается по необходимости, в нём может быть длинная инструкция под конкретную задачу.

Что такое MCP в Claude Code?

Стандарт подключения внешних сервисов: браузера, документации, баз данных, GitHub. Подключается командой claude mcp add.

Почему хук не останавливает агента?

Блокирует только код выхода 2. Код 1 считается неблокирующей ошибкой. Используйте команда >&2 || exit 2.

Безопасно ли ставить чужие скиллы и MCP?

Только из проверенных источников и после чтения: скилл — это инструкция, которую выполнит агент, а MCP — доступ к вашим данным.

Читать дальше

Ещё по теме

Довести проект до прода заявка

Что дальше

Два пути после вайбкода

Первый шаг

Проект до прода
или работа в команде?

Расскажите про проект или про себя. Ответим в течение рабочего дня.

Владислав Терещенко
Ваш контактВладислав Терещенко

Основатель Edemium

Сначала поймём задачу.
Потом предложим следующий шаг.

С чем приходите?

Ответим в течение рабочего дня.