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

Claude Code настраивается пятью способами: скиллы дают знания, субагенты — помощников, хуки — автоматические правила, MCP — доступ к внешним сервисам, плагины упаковывают всё это для установки одной командой.
Скиллы
Папка с инструкцией и файлами: «как у нас делают документы», «как выкатывать сайт». Агент подгружает её, только когда задача подходит.
Субагенты
Отдельные агенты со своей ролью и моделью: «ревьюер кода», «исследователь». Работают параллельно и не засоряют основной разговор.
Хуки
Команды, которые запускаются сами на события: перед правкой файла, после неё, когда агент закончил. Не просьба, а правило.
MCP
Подключение внешних сервисов: браузер, документация библиотек, база данных, GitHub, почта.
Плагины
Набор из скиллов, команд, субагентов, хуков и MCP одним пакетом — чтобы поставить себе или команде одной командой.
Новичку не нужно всё сразу. Порядок, который окупается: сначала файл памяти CLAUDE.md, потом один-два MCP (документация и браузер), потом скиллы под повторяющиеся задачи, и только потом хуки.
02 · Знания
Claude Code skills: что это и как сделать свой скилл

Скилл — папка с файлом 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/agents/. Типичные роли:
- Исследователь — ищет по большому проекту и возвращает только выводы.
- Ревьюер — смотрит изменения свежим взглядом и ищет ошибки.
- Тестировщик — запускает проверки и разбирает падения.
Главная экономия — в выборе модели: рутинному субагенту, который просто читает файлы, не нужна самая дорогая модель. Укажите в его настройках быструю и дешёвую — и лимит подписки проживёт заметно дольше. Подробно про экономию — в статье «Токены Claude Code».
04 · Правила
Хуки Claude Code: правила, которые агент не может нарушить

Хук — команда, которую Claude Code запускает сам на определённое событие: перед действием, после правки, по окончании работы. Просьбу в CLAUDE.md агент может забыть, хук сработает всегда.
{
"hooks": {
"Stop": [
{ "hooks": [
{ "type": "command",
"command": "npm test >&2 || exit 2" }
] }
]
}
}Когда агент решил, что закончил, запускаются тесты. Если упали — код выхода 2 возвращает агента к работе и передаёт ему текст ошибки.
Частая ошибка при настройке хуков: скрипт падает с кодом 1, и ничего не происходит. В Claude Code блокирует только код выхода 2: текст из потока ошибок передаётся агенту, и он возвращается к задаче. Код 1 считается неблокирующей ошибкой, и агент спокойно идёт дальше. Отсюда конструкция команда >&2 || exit 2.
Что ещё делают хуками: запрещают правку файлов с ключами, автоматически форматируют код после каждой правки, присылают уведомление, когда агент закончил долгую задачу. Осторожно с хуком на окончание: если тест не может пройти в принципе, агент будет крутиться по кругу — следите за первыми запусками.
05 · Сервисы
MCP в Claude Code: как подключить внешние сервисы

MCP — открытый стандарт, по которому агент подключается к внешним сервисам: браузеру, документации, базе данных, GitHub, почте. Подключается одной командой claude mcp add.
# свежая документация библиотек вместо устаревших знаний модели 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 закрывает вторую боль — «агент сказал готово, а страница сломана»: агент сам открывает страницу, смотрит на неё и исправляет.
- Документация библиотек — чтобы код писался под актуальные версии.
- Браузер — чтобы агент сам проверял страницы.
- База данных (например, 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 — доступ к вашим данным.
Читать дальше
