Сабагенты и скиллы

Сабагенты и скиллы — два механизма масштабирования Claude Code за пределы одного диалога. Сабагенты — параллельные экземпляры агента, которые Claude Code порождает под независимые под-задачи: поиск по кодовой базе, исследование незнакомого модуля, ревью изменений. Скиллы — переиспользуемые пакеты инструкций, подгружаемые в контекст по требованию: вызовом slash-команды (/name) или автоматически, когда описание скилла совпадает с задачей. Вместе они превращают Claude Code из «умного чата в терминале» в оркестратор рабочих процессов с маленьким базовым контекстом.

Как это работает

Кастомные типы агентов описываются markdown-файлами с frontmatter в .claude/agents/: имя, описание, разрешённые инструменты и модель. Классический паттерн — read-only агент Explore для быстрого поиска по коду: правки ему запрещены, поэтому его безопасно запускать параллельно основной работе. Скилл — это папка с файлом SKILL.md (тоже с frontmatter), лежащая в .claude/skills/ (проектные скиллы) или ~/.claude/skills (пользовательские). Ключевое отличие от CLAUDE.md: CLAUDE.md всегда находится в контексте целиком, а у скилла в контексте постоянно живёт только описание — тело загружается лишь тогда, когда оно релевантно задаче. Принцип: базовый контекст держим маленьким, детали подгружаем по требованию.

Когда применять

Сабагентов запускайте для независимых потоков работы: пока основной агент пишет код, сабагент ищет использования API или ревьюит изменения в соседнем пакете. Скилл заводите по простому правилу: вставили в чат одни и те же инструкции дважды — повышайте их до скилла. Для событийной автоматики (линтер после каждой правки) подходят hooks — shell-команды на события харнесса; для внешних инструментов — MCP-серверы, а не скиллы.

Типичные ошибки

Размытое описание скилла — главный промах: именно описание гейтит автотриггер, и неточная формулировка означает, что скилл либо не срабатывает, либо срабатывает не к месту. Другие ловушки: перенос всего CLAUDE.md в скиллы (базовые правила проекта должны быть в контексте всегда); выдача сабагенту полного набора инструментов там, где достаточно read-only; ожидание, что скилл сработает «по расписанию» — события и расписания решаются hooks, а не скиллами; раздувание SKILL.md до размеров, при которых теряется весь выигрыш от ленивой загрузки.

Как это работает

Когда применять

Типичные ошибки

Связанные понятия

Полезные ресурсы