Что такое скилл в Claude Code
Скилл — это отдельная папка, в которой лежит файл SKILL.md. В начале файла — короткая шапка с именем и описанием скилла, ниже — сама инструкция: что делать, в каком порядке, чего избегать. Рядом с SKILL.md можно положить шаблоны, справочники и скрипты, на которые инструкция ссылается.
Главное отличие скилла от обычной подсказки в чате — он подключается сам. При запуске Claude Code видит только имена и описания всех доступных скиллов. Когда ваша просьба подходит под описание, Claude Code загружает полный текст нужного SKILL.md и работает по нему. Остальные скиллы в диалог не попадают и место в контексте не занимают.
Так один раз описанный порядок работы повторяется каждый раз одинаково: не нужно заново объяснять, как у вас принято писать тесты, оформлять коммиты или собирать релиз. Скилл можно держать для себя, а можно положить в репозиторий, чтобы им пользовалась вся команда.
Чем скилл отличается от CLAUDE.md, MCP и команд
В Claude Code есть несколько способов дать модели знания и инструменты. Они не заменяют друг друга, а дополняют.
- CLAUDE.md
- Общие правила проекта. Файл читается в каждой сессии целиком, поэтому туда стоит класть только то, что нужно всегда: стек, команды сборки, стиль кода.
- Скилл
- Инструкция под отдельную задачу. Загружается, только когда задача подходит под описание, поэтому скиллов может быть много без лишнего расхода контекста.
- MCP-сервер
- Подключает внешние инструменты и данные: базу, трекер задач, браузер. Скилл может подсказывать, как этими инструментами пользоваться, но сам их не добавляет.
- Команда со слешем
- Вызывается вручную. Скилл тоже можно вызвать вручную командой
/имя-скилла, но обычно Claude Code подключает его сам. - Субагент
- Отдельный помощник со своим контекстом для длинных побочных задач. Скилл же работает внутри текущего диалога.
Простое правило: если вы объясняете Claude Code одно и то же второй раз — это кандидат в скилл; если правило нужно в каждом запросе — ему место в CLAUDE.md.
Где лежат скиллы
Claude Code ищет скиллы в трёх местах. Имя папки — это имя скилла: короткое, латиницей, слова через дефис.
- Личные
~/.claude/skills/<имя>/SKILL.md— работают во всех ваших проектах на этом компьютере. На Windows папка.claudeлежит в папке пользователя.- Проектные
.claude/skills/<имя>/SKILL.mdв корне репозитория — попадают в git вместе с кодом, и у коллег скилл появится после обновления репозитория.- Из плагинов
- Плагины Claude Code тоже приносят скиллы. Установка плагинов — командой
/pluginвнутри Claude Code.
Личные скиллы удобны для своих привычек: как вы пишете коммиты, как ведёте заметки. Проектные — для правил команды: как устроены миграции, как называть ветки, что проверить перед релизом.
Как создать свой скилл
Свой скилл собирается за несколько минут. Для примера сделаем скилл, который пишет сообщение коммита по вашим правилам.
- Создайте папку скилла. Для личного скилла — в
~/.claude/skills, для проектного — в.claude/skillsвнутри репозитория. - Создайте файл SKILL.md. В шапке между строками
---укажитеnameиdescription, ниже — инструкцию обычным текстом. - Напишите точное описание. По нему Claude Code решает, когда подключить скилл. Описывайте и что скилл делает, и когда его использовать.
- Откройте новую сессию Claude Code и попросите сделать задачу из описания — например, «закоммить изменения».
macOS и Linux — в Терминале:
mkdir -p ~/.claude/skills/commit-message
Windows — в PowerShell:
New-Item -ItemType Directory -Force "$HOME\.claude\skills\commit-message"
Содержимое файла SKILL.md в этой папке:
--- name: commit-message description: Пишет сообщение коммита по изменениям в git. Используй, когда просят закоммитить изменения или описать их для коммита. --- # Сообщение коммита 1. Посмотри подготовленные изменения: git diff --staged. 2. Первая строка — коротко, что сделано, без точки в конце. 3. Ниже — пустая строка и список изменений по пунктам. 4. Не вставляй в сообщение ключи, пароли и адреса серверов.
Шапка обязательна: без name и description скилл не появится в списке. Инструкцию пишите так же, как объяснили бы задачу новому коллеге: по шагам, с примерами хорошего и плохого результата. Если инструкция разрастается, вынесите справочные части в отдельные файлы рядом и сошлитесь на них из SKILL.md — Claude Code откроет их, только когда они понадобятся.
В шапке можно указать и поле allowed-tools — список инструментов, которыми Claude Code может пользоваться в этом скилле без лишних вопросов. Например, скиллу для ревью достаточно чтения файлов и поиска, а запись ему не нужна.
Какие скиллы сделать первыми
Готового списка «лучших» скиллов нет: самые полезные — те, что повторяют вашу ежедневную работу. Вот задачи, которые чаще всего стоит оформить скиллом.
- Сообщения коммитов. Формат первой строки, язык, что упоминать, а что нет.
- Ревью кода. Ваш чек-лист: ошибки, безопасность, тесты, стиль, что проверить в первую очередь.
- Тесты. Где лежат тесты, какой фреймворк, как называть, как запускать один тест и весь набор.
- Миграции базы. Как создать миграцию, как проверить откат, что нельзя делать на живой базе.
- Релиз и список изменений. Из каких коммитов собирать заметки к релизу и в каком виде.
- Документация. Шаблон README или описания модуля, тон, обязательные разделы.
- Разбор ошибок. Где смотреть логи, какие команды запускать, как описать причину и исправление.
- Работа с документами. Скрипты для выгрузки таблиц, отчётов и PDF, которые Claude Code запускает сам.
Начните с одного-двух скиллов под самые частые задачи. Посмотрите, как Claude Code их подхватывает, и уточните описание, если он подключает скилл не тогда, когда нужно.
Как запустить и проверить скилл
Скилл не нужно включать отдельно: достаточно, чтобы папка с SKILL.md лежала на своём месте. Откройте новое окно терминала и запустите claude в папке проекта.
- Спросите о скиллах. Напишите «какие скиллы тебе доступны?» — Claude Code перечислит их по именам и описаниям.
- Дайте задачу из описания. Например, «закоммить изменения». Claude Code сам подключит скилл и напишет, что работает по нему.
- Вызовите вручную, если нужно точно этот скилл: команда
/commit-message.
Скилл правится как обычный текстовый файл. После правки откройте новую сессию — так Claude Code точно прочтёт свежую версию.
Скиллы и расход объёма на ключе
Скиллы помогают тратить объём бережнее, чем длинный CLAUDE.md. В каждый запрос попадают только имена и описания скиллов, а полный текст — лишь того скилла, который нужен сейчас.
- Держите SKILL.md коротким. Загруженный скилл остаётся в диалоге и на каждом ходу отправляется вместе с контекстом. Эта часть оплачивается по обычному тарифу входа выбранной модели.
- Выносите справочники в файлы. Длинные таблицы и примеры читаются только по ссылке из инструкции, когда они действительно нужны.
- Отдавайте рутину скриптам. Если скилл запускает скрипт, в диалог попадает только его вывод, а не код целиком.
- Сбрасывайте длинный диалог. Команда
/clearначинает новую сессию, и вместе с ней уходят загруженные скиллы.
Сколько списал каждый запрос — вход, выход и множитель модели — видно в личном кабинете по тому же ключу. Цены моделей в рублях — на странице моделей и цен.
Claude Code со скиллами по ключу CheapDev
Скиллы работают на стороне Claude Code: это файлы на вашем компьютере. Поэтому они работают одинаково с аккаунтом Anthropic и с ключом CheapDev — менять в скиллах ничего не нужно.
Чтобы подключить Claude Code к ключу, купите ключ на маркетплейсе (Plati, GGsel, PlayerOK, Starvell, Яндекс Маркет), скопируйте ключ tpk_… со страницы заказа и запустите команду установки. Она пропишет адрес и ключ в настройки Claude Code, а ваши скиллы и остальные настройки не тронет.
curl -fsSL https://cheapdev.store/install.sh | bash
На Windows та же установка идёт в PowerShell командой irm https://cheapdev.store/install.ps1 | iex. Подробно по шагам, с ручной настройкой и проверкой, — в гайде Claude Code в России и на странице Claude Code по ключу.
После установки основная модель — Claude Sonnet 5 (claude-sonnet-5). Для сложных скиллов вроде ревью большой ветки можно переключиться на Claude Opus 5.5 командой /model opus — он списывает объём быстрее, поэтому включайте его под отдельные задачи.
Если скилл не срабатывает
- Скилла нет в списке
- Проверьте путь: файл должен называться ровно
SKILL.mdи лежать в своей папке внутри.claude/skills. Проверьте шапку: строки---сверху и снизу, поляnameиdescription. Откройте новую сессию. - Скилл есть, но не подключается сам
- Описание слишком общее. Допишите в
description, когда именно его использовать, теми словами, какими вы ставите задачу. Или вызовите скилл вручную командой со слешем. - Подключается не тот скилл
- Описания двух скиллов похожи. Разведите их: в каждом укажите, для каких задач он, а для каких — нет.
- Claude Code просит войти или отвечает 401
- Это не скиллы, а настройка ключа. Запустите команду установки ещё раз и откройте новое окно. Разбор кодов ответа — в гайде об ошибках Claude API.
- Ошибки только в длинной сессии
- Диалог стал слишком длинным. Начните новую сессию командой
/clearи отключите лишние MCP-серверы командой/mcp.
Не помогло — напишите в поддержку: кнопка «Поддержка» внизу справа на любой странице сайта. Укажите номер заказа и первые символы ключа; ключ целиком не присылайте.
Вопросы
Что такое скиллы Claude Code?
Это папки с файлом SKILL.md: в шапке имя и описание, ниже инструкция под задачу. Claude Code подключает скилл сам, когда просьба подходит под описание, или по команде со слешем.
Где лежат скиллы Claude Code?
Личные — в папке .claude/skills в домашней папке пользователя, проектные — в .claude/skills внутри репозитория. Ещё скиллы приносят плагины Claude Code.
Работают ли скиллы с ключом CheapDev?
Да. Скиллы — это файлы на вашем компьютере, Claude Code читает их сам. По ключу CheapDev они работают так же, как с аккаунтом Anthropic, менять в них ничего не нужно.
Тратят ли скиллы объём на ключе?
Немного: в каждый запрос попадают имена и описания скиллов, а полный текст — только у скилла, который сейчас в работе. Расход по каждому запросу виден в личном кабинете.
Нужен ли аккаунт Anthropic для Claude Code?
Нет. Вход в сервис — по ключу, без регистрации и пароля. Команда установки пропишет адрес и ключ в настройки Claude Code, скиллы при этом не меняются.
Ещё по теме
- Claude Code в России — ключ и подключение за 3 шага.
- Ошибки Claude API — коды ответа и что делать.
- Claude Code по ключу — установщик, модели и ограничения.
Ещё нет ключа? Покупка — на маркетплейсах. Ключ придёт в заказе на площадке сразу после оплаты.
Рассчитать и оплатить