Agent Skills — это способ один раз записать свой подход к задаче и переиспользовать его во всех проектах. Разберём, что это, как подключать через файл и маркетплейс, и как собрать набор конкретно под себя.
Если ты уже пишешь с Claude Code, то наверняка ловил себя на том, что в каждом новом чате заново объясняешь одно и то же: «пиши тесты сначала», «комментарии на русском», «не трогай миграции руками». Скилы (Agent Skills) — это лекарство ровно от этого. Ты один раз формулируешь свой подход, и Claude подхватывает его сам, когда задача подходит.
Что узнаешь из гайда
SKILL.md — на реальном примереЧасть 1 · Понятие
Главное
Скил — это папка с файлом-инструкцией, которую Claude подключает сам, когда задача под неё подходит. Промт ты пишешь руками каждый раз; скил модель достаёт автоматически.
Расшифруем по словам. Agent — это сам Claude Code, который действует в терминале как агент: читает файлы, запускает команды, правит код. Skill (навык) — заранее записанная инструкция «как делать вот эту штуку правильно». Технически скил — это директория с файлом SKILL.md внутри. В заголовке файла — короткое описание, по которому Claude понимает, когда навык уместен. В теле — собственно инструкции.
Ключевая идея в слове «автоматически». Тебе не нужно звать скил командой. Claude читает описания всех доступных навыков, и когда ты просишь, например, разобрать PDF или причесать SQL-запрос, он сам вспоминает: «о, под это есть скил» — и применяет его инструкции. Пока навык не нужен, он не висит в контексте и не съедает токены.
| Инструмент | Как запускается | Живёт |
|---|---|---|
| Промт | Пишешь руками в чате | Одну сессию |
| Slash-команда | Явный вызов: /имя | Постоянно, но по требованию |
| Скил | Claude подключает сам по описанию | Постоянно, фоном |
Грубая аналогия: промт — это разовое поручение, slash-команда — кнопка на пульте, а скил — это навык сотрудника, который он применяет сам, когда видит подходящую задачу. Подробнее про команды и пульт — в гайде про все команды Claude Code.
Часть 2 · Внутри
Главное
SKILL.md состоит из двух частей: YAML-заголовок с описанием (по нему Claude решает, когда навык применить) и тело с инструкциями на обычном markdown.
Вот минимальный рабочий скил. Заголовок между --- — это и есть триггер: фраза в description объясняет Claude, когда лезть за этим навыком. Чем точнее описание, тем чаще скил срабатывает там, где надо, и реже — где не надо.
---
# description читает Claude, чтобы понять, КОГДА применять навык.
# Пиши на английском: модель точнее матчит триггеры, экономит токены.
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---
When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverageТело — это твоя методичка. Сюда складывают чек-листы, правила, примеры, ссылки на доку. Claude читает её только когда навык сработал, поэтому тело может быть подробным — на токены в простое оно не влияет.
Важно
Имя папки = имя скила. Файл всегда называется ровно SKILL.md (заглавными). Описание в заголовке пиши на английском, даже если работаешь на русском: матчинг точнее, а сами инструкции в теле можно держать как удобно. Почему английский экономит токены — разбираем в гайде про экономию лимитов.
Часть 3 · Установка
Главное
Два места: личное (~/.claude/skills/ — работает во всех проектах) и проектное (.claude/skills/ в репозитории — едет в гит с кодом).
Самый прямой путь. Создаёшь папку под скил и кладёшь туда SKILL.md. Для личного навыка, который нужен везде:
# Создаём папку под личный навык (доступен во всех проектах)
mkdir -p ~/.claude/skills/summarize-changes
# Дальше кладём туда SKILL.md и пишем инструкции
# Claude подхватит его автоматически в следующей сессииЕсли навык нужен только в одном проекте и должен ехать в команду вместе с кодом — кладёшь его внутрь репозитория:
# Внутри репозитория проекта
mkdir -p .claude/skills/our-db-conventions
# SKILL.md тут попадёт в гит — вся команда получит навык
# при следующем git pullСкилы упаковывают в плагины и раздают через маркетплейсы — это просто GitHub-репозиторий со списком навыков. Подключается в два шага прямо из чата Claude Code:
# 1. Добавляем маркетплейс (owner/repo с GitHub, git-URL или локальный путь)
/plugin marketplace add owner/repo
# 2. Ставим конкретный плагин из него
/plugin install имя-плагина@имя-маркетплейсаПосле установки Claude видит навыки из плагина так же, как твои собственные — подключает по описанию. Управлять маркетплейсами можно и из обычного терминала командой claude plugin marketplace add, и интерактивно через /plugin.
Коротко
SKILL.md в ~/.claude/skills/ (везде) или .claude/skills/ (в проекте, в гит)./plugin marketplace add → /plugin install.Часть 4 · Источник
Писать каждый навык с нуля необязательно. Сообщество уже собрало тысячи скилов — от ревью кода и работы с базами до генерации лендингов и разбора документов. Разумная стратегия: взять готовый, посмотреть как он устроен, и допилить под свой стиль.
На русском самый большой источник — это маркетплейс скилов ИИ-офиса: 1300+ готовых навыков для Claude Code и других редакторов, с описанием, категориями (разработка, дизайн, контент, данные, автоматизация) и инструкцией установки у каждого. Можно поставить навык в один шаг или открыть его исходник и собрать свой на этой базе.
Не пиши с нуля то, что уже написано. Возьми готовый скил, разбери и сделай своим.
Логика выбора простая: ищешь навык под свою повторяющуюся задачу (например, «ревью pull request» или «оптимизация SQL»), ставишь, гоняешь пару раз. Если поведение нравится — оставляешь. Если хочется иначе — копируешь SKILL.md к себе в ~/.claude/skills/ и правишь описание и инструкции под свои привычки.
Часть 5 · Сборка
Главное
Не строй «библиотеку на всё». Заведи скилы только под задачи, которые повторяешь и каждый раз объясняешь заново. Три-пять рабочих навыков полезнее тридцати «на всякий случай».
Рабочий способ собрать свой набор — наблюдать за собой неделю. Каждый раз, когда ты в чате пишешь Claude одну и ту же инструкцию руками, это кандидат в скилы. Дальше — по шагам:
~/.claude/skills/, внутри SKILL.md с чётким description на английском.Когда скил не нужен
Если инструкция одноразовая или специфична для конкретного чата — это просто промт, не скил. Не плоди навыки под каждую мелочь: чем их больше, тем хуже Claude выбирает нужный. Общие правила всего проекта (а не отдельная задача) лучше держать в CLAUDE.md — он читается всегда, а скил только под свою задачу.
Пример набора
У вайбкодера обычно живут 4-5 скилов: ревью кода, конвенции коммитов, правила тестирования, разбор документов и «причеши текст». Этого хватает на 90% рутины. Остальное — разовые промты.
Коротко
~/.claude/skills/ или .claude/skills/) либо маркетплейс на GitHub.Вопросы
Agent Skill — это папка с файлом SKILL.md, где в YAML-заголовке описано, когда навык применять, а в теле — инструкции, которым Claude следует. Claude сам читает описания всех доступных скилов и подключает нужный, когда задача под него подходит. Это способ один раз записать свой подход к задаче и переиспользовать его во всех проектах.
Личный скил кладётся в папку ~/.claude/skills/<имя>/SKILL.md и работает во всех проектах; проектный — в .claude/skills/ внутри репозитория и едет в гит вместе с кодом. Готовый набор подключается из маркетплейса командой /plugin marketplace add и установкой /plugin install. После подключения Claude видит скил автоматически, отдельная команда запуска не нужна.
Готовые скилы берут из маркетплейсов на GitHub и из тематических подборок. На русском есть маркетплейс ИИ-офиса с 1300+ навыками по разработке, дизайну, контенту, данным и автоматизации — каждый с описанием и инструкцией установки. Можно поставить готовый скил, разобрать как он устроен и на его основе собрать свой.
Скил подключается автоматически по описанию, а slash-команда и промт запускаются руками. Claude сам решает, что задача подходит под скил, и достаёт инструкции, не засоряя контекст, пока навык не нужен. Промт живёт одну сессию, slash-команда — это явный вызов, а скил — постоянная фоновая способность, которую модель применяет сама в нужный момент.
Читать дальше
Не собирай библиотеку с нуля. Загляни в маркетплейс ИИ-офиса: навыки по разработке, дизайну, контенту и автоматизации, каждый с описанием и установкой. Поставь готовый или собери свой на его базе.
Открыть маркетплейс скиловА разборы, эфиры и живое сообщество вайбкодеров — в Telegram ИИ-офиса.