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

Для этого в Claude Code есть навыки, по-английски skills. Навык — это сохранённая инструкция, которую Claude сам достаёт, когда задача на неё похожа. Ниже разберём, как устроены навыки Claude Code, и шаг за шагом напишем свой на примере ответов гостям кофейни.

Что такое навыки (skills) в Claude Code

Навык похож на памятку в папке у сотрудника. Он не держит её в голове постоянно, но знает, что она есть, и открывает, когда приходит подходящая задача.

Так навык и работает. Claude Code всё время помнит только короткое описание каждого навыка, одну-две фразы. Полный текст он читает, когда решит, что навык пригодится, или когда вы вызовете его сами.

Из этого следуют две полезные вещи:

• навыков может быть много, и они почти не занимают места в памяти разговора;
• от описания зависит всё: если по нему непонятно, когда навык нужен, Claude его не вспомнит.

Чем навык отличается от CLAUDE.md

У Claude Code есть ещё файл CLAUDE.md с правилами проекта, его создают командой /init. Как он работает, разобрано в статье как пользоваться Claude Code. Разница в том, когда Claude читает каждый из них.

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

Где лежат навыки

Каждый навык это отдельная папка, а в ней файл SKILL.md. Где лежит папка, определяет, где навык работает:

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

Как написать свой навык: пошагово

Покажем на навыке, который пишет ответы на отзывы гостей. Кофейня и правила придуманы для примера, но сам навык мы создали и проверили в Claude Code.

Шаг 1. Создайте папку навыка

Папку можно создать в Finder или в проводнике: внутри папки проекта папка .claude, в ней skills, в ней папка с именем навыка. Имя пишите латиницей через дефис. Или выполните в терминале своего компьютера, находясь в папке проекта:

bash mkdir -p .claude/skills/otvet-klientu

Папки с точкой в начале имени на Mac и в Linux скрыты. В Finder их показывает сочетание клавиш Cmd + Shift + точка.

Шаг 2. Напишите файл SKILL.md

В папке навыка создайте текстовый файл SKILL.md, например в VS Code или любом текстовом редакторе. При сохранении укажите имя SKILL.md целиком, чтобы редактор не дописал .txt. Сверху, между двумя строками из трёх дефисов, стоит шапка с именем и описанием. Ниже обычным текстом сама инструкция:

```markdown

name: otvet-klientu description: Черновик ответа клиенту кофейни на отзыв или жалобу. Используй, когда просят ответить на отзыв, жалобу или письмо гостя.

Ответ клиенту

1. Обратись к гостю по имени, если оно есть.
2. Поблагодари за отзыв одной фразой.
3. Если есть жалоба, признай проблему и скажи, что сделаем: заменим напиток, вернём деньги или разберёмся с бариста.
4. Не обещай скидки и подарки: это решает управляющий.
5. Подпись всегда: «Анна, управляющая кофейни „Зерно“».
6. Не больше 4 предложений. ```

Самая важная строка здесь description. В ней две части: что навык делает и когда его использовать. По второй части Claude понимает, что просьба «ответь на отзыв» относится к этому навыку.

Шаг 3. Проверьте, что Claude видит навык

Откройте Claude Code в папке проекта и спросите: «Какие навыки тебе доступны?» В нашей проверке Claude первым в списке назвал otvet-klientu.

Ещё один способ: наберите в поле ввода косую черту /. Откроется меню, и ваш навык будет в нём вместе с описанием.

Шаг 4. Проверьте, что навык срабатывает сам

Напишите задачу обычными словами, не упоминая навык. Мы написали: «Ответь на отзыв: „Взял латте, а он был холодный. Олег“». Claude сам открыл навык и ответил:

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

Анна, управляющая кофейни «Зерно»

Все правила на месте: обращение по имени, извинение, замена или возврат денег, без скидок, подпись из навыка. Без навыка подпись Claude взять неоткуда.

Шаг 5. Вызовите навык вручную

Навык можно вызвать и напрямую: косая черта, имя навыка и текст задачи.

/otvet-klientu Очень вкусный медовик, спасибо! Марина

Текст после имени навыка Claude получает как задание. На этот отзыв Claude поблагодарил Марину, пообещал передать её слова кондитерам и подписался так же, как требует навык.

Дополнительные настройки навыка

В шапку SKILL.md можно добавить строки, которые меняют поведение навыка:

• disable-model-invocation: true. Claude не будет запускать навык сам, только по вашей команде через /. Это для навыков, которые что-то отправляют или публикуют: такие действия лучше запускать осознанно.
• allowed-tools. Действия, которые Claude может делать во время навыка без вопроса о разрешении. Разрешение действует до вашего следующего сообщения.
• arguments. Имена для частей задания. Например, навык «КП для клиента» может принимать имя клиента и сумму отдельными словами после команды.

Так выглядит шапка навыка, который Claude не запустит сам и который принимает два слова после команды:

```markdown

name: kp-klientu description: Коммерческое предложение по шаблону кофейни. disable-model-invocation: true arguments: [klient, summa]

Подготовь КП для клиента $klient на сумму $summa ₽ по шаблону из файла shablon.md. ```

Вызов: /kp-klientu Ромашка 45000. В нашей проверке Claude открыл шаблон из папки навыка и подставил в него «Ромашку» и 45 000 ₽.

Рядом с SKILL.md можно положить другие файлы: шаблон письма, примеры удачных ответов, прайс. В тексте навыка достаточно сослаться на них, например «образцы ответов в файле examples.md». Claude откроет их, только когда они понадобятся.

Если навык не работает

Какие навыки сделать первыми

Навык окупается там, где вы повторяете одни и те же объяснения. Для небольшого бизнеса это обычно:

• ответы на отзывы и письма с вашим тоном и подписью;
• коммерческое предложение по шаблону с вашими ценами и условиями;
• проверка текста перед публикацией по вашему списку правил;
• разбор выгрузки, например отчёта о продажах, в одном и том же виде каждую неделю.

Навыки хорошо работают вместе с MCP-серверами, которые дают Claude доступ к вашим программам. Навык описывает, как действовать, а сервер даёт данные, например остатки склада или письма. Как подключить такой сервер, разобрано в инструкции как подключить MCP-сервер.

Если Claude Code вам недоступен, другие помощники для работы с кодом, например GigaCode от Сбера, сравниваются в обзоре моделей для вайб-кодинга.