Claude Code: агенты и скиллы - автоматизация разработки

Claude Code автоматизируют тремя кирпичами. Скиллы - папки с инструкцией, которые агент подхватывает сам, когда они к месту. Субагенты - отдельные копии Claude под конкретную задачу, каждая со своим контекстом. Плагины пакуют и то и другое для установки одной командой. Всё лежит в папке .claude и включается обычными словами. Разберём каждый кирпич и как собрать своё.

Если ты только ставишь Claude Code, начни с основ - что это и как войти. А эта статья про следующий уровень: как перестать повторять одни и те же инструкции руками и научить агента делать рутину самому.

Три кирпича автоматизации

Из коробки Claude Code расширяется тремя способами, и путать их не стоит - каждый решает свою задачу.

• Скиллы - долгоживущая экспертиза. Папка с файлом-инструкцией, которую агент загружает, только когда она нужна.
• Субагенты - отдельные экземпляры Claude под узкую роль: ревьюер, отладчик, исследователь. У каждого свой контекст и свой набор инструментов.
• Плагины - способ упаковать скиллы, субагентов, хуки и MCP-серверы в один пакет и поставить его одной командой.

Есть ещё хуки - шелл-команды, которые срабатывают на события жизненного цикла (например, прогнать линтер после каждой правки). Но основа автоматизации - именно скиллы и агенты, с них и начнём.

Скиллы: папка с инструкцией

Скилл - это папка с файлом SKILL.md внутри. В файле две части: YAML-шапка с полем description, которое подсказывает агенту, когда скилл применять, и ниже - сам текст инструкции. Имя папки становится командой: скилл в папке deploy вызывается как /deploy.

Работает это двумя путями. Можно вызвать скилл руками через /имя-скилла, а можно ничего не набирать - если запрос совпадает по смыслу с description, Claude Code подхватит скилл сам. Главная выгода в том, что тело скилла загружается только в момент использования, поэтому длинная инструкция ничего не стоит, пока не понадобится.

Где лежат скиллы, определяет, кто ими пользуется:

Где	Путь	Применяется
Личные	~/.claude/skills/<имя>/SKILL.md	во всех твоих проектах
Проектные	.claude/skills/<имя>/SKILL.md	только в этом проекте
Из плагина	<плагин>/skills/<имя>/SKILL.md	где включён плагин

Скиллы Claude Code следуют открытому стандарту Agent Skills, так что тот же формат понимают и другие инструменты. А бывшие пользовательские команды из .claude/commands/ теперь тоже часть скиллов - старые файлы продолжают работать.

Как сделать свой скилл за пять минут

Никакого кода не нужно. Разберём на скилле, который разбирает незакоммиченные изменения и подсвечивает рискованное.

Сначала создаём папку в личных скиллах: mkdir -p ~/.claude/skills/summarize-changes. Затем кладём туда SKILL.md:

---
description: Разбирает незакоммиченные изменения и подсвечивает риски. Использовать, когда просят показать, что изменилось, или собрать коммит.
---

## Текущие изменения

!`git diff HEAD`

## Инструкция

Кратко опиши изменения выше в двух-трёх пунктах, затем перечисли риски:
пропущенная обработка ошибок, захардкоженные значения, тесты, которые надо обновить.

Строка !`git diff HEAD` - это инъекция контекста: Claude Code сам выполнит команду и подставит её вывод в текст скилла до того, как агент его прочитает. То есть инструкция приходит уже с актуальным диффом внутри. Дальше открываешь проект, набираешь claude и либо спрашиваешь «что я изменил?», либо вызываешь /summarize-changes напрямую.

Субагенты: отдельный Claude под задачу

Субагент - это специализированный экземпляр Claude со своим отдельным контекстным окном. Зачем это нужно: когда ты просишь провести ревью, субагент-ревьюер делает это в своём контексте и не засоряет основную сессию сотнями прочитанных файлов. Плюс субагенту можно урезать права - выдать только чтение, чтобы он ничего не сломал.

Живут субагенты в файлах .claude/agents/*.md (проектные) или ~/.claude/agents/*.md (личные). Формат тот же - YAML-шапка и системный промпт:

---
name: code-reviewer
description: Ревью кода. Использовать после правок в коде.
tools: Read, Grep, Glob, Bash
model: sonnet
---

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

Обязательны только два поля: name и description. Остальное по желанию - tools ограничивает набор инструментов, model задаёт модель под задачу (например, лёгкие ревью на Haiku, сложные на Opus). Ключевое - description: именно по нему Claude Code решает, кому делегировать. Если написать «использовать после правок в коде», агент будет звать ревьюера сам.

Как создать субагента

Два простых пути. Первый - попросить сам Claude Code: «Создай личного субагента-ревьюера в ~/.claude/agents/, только для чтения, на модели Sonnet». Агент напишет файл сам и подхватит его через пару секунд без перезапуска. Второй - создать .md-файл руками по шаблону выше.

Кстати, встроенные субагенты у Claude Code уже есть: Explore для быстрого поиска по коду, Plan для сбора контекста перед планом и general-purpose для сложных многошаговых задач. Свои субагенты просто добавляются к ним.

Плагины и маркетплейсы

Когда набор скиллов и агентов хочется переиспользовать между проектами или раздать команде, их пакуют в плагин. Плагин ставится из маркетплейса двумя командами:

Сначала подключаешь маркетплейс: /plugin marketplace add anthropics/claude-plugins-official. Потом ставишь нужный плагин: /plugin install skill-creator@claude-plugins-official. Управлять установленным можно через меню /plugin. Один плагин может нести сразу скиллы, субагентов, хуки и MCP-серверы - то есть целый готовый набор автоматизаций под конкретную область.

Хороший старт - официальный плагин skill-creator: он помогает писать и вылизывать собственные скиллы прямо внутри Claude Code.

Скилл, субагент или MCP - что когда

Три инструмента легко перепутать, поэтому короткая развилка:

• Скилл - когда есть повторяющаяся процедура или чек-лист, который ты раз за разом диктуешь агенту. Ты выносишь инструкцию в SKILL.md - и она подгружается по надобности.
• Субагент - когда задачу лучше делать в отдельном контексте: параллельно, с урезанными правами или на другой модели.
• MCP - когда агенту нужен доступ к внешнему сервису: базе данных, трекеру, браузеру. Это отдельный механизм подключения, а не про инструкции.

С чего начать

Не строй сразу фабрику агентов. Возьми одну рутину, которую делаешь руками каждый день - сборку коммита, прогон тестов, проверку стиля - и вынеси её в один скилл. Пять минут, папка и SKILL.md. Как только увидишь, что агент подхватывает её сам в нужный момент, дальше уже сам поймёшь, что стоит автоматизировать следующим.

А чтобы не изобретать велосипед, сначала загляни в официальный маркетплейс и готовые скиллы - половина типовых процедур уже написана до тебя. Когда база освоена, следующий шаг - работа через CLI и API, где Claude Code встраивается прямо в твои скрипты и CI.