Skill для Claude Code это папка. В ней лежит файл SKILL.md: короткий YAML-заголовок и инструкции на Markdown. На этом идея заканчивается. Если запрос совпадает с описанием скилла, Claude читает файл и действует по нему: ваши договорённости, ваши шаги, ваши подводные камни. В остальное время файл лежит без дела и ничего не стоит.
Skills любят за простоту. Писать код, поднимать сервер и изучать API не нужно. Вы записываете задачу так, как объяснили бы новому коллеге, сохраняете в SKILL.md, и Claude подхватывает. Каждый день вставляете в Claude Code одну и ту же простыню инструкций? Skill избавит от этой привычки.
Дальше по порядку: что такое Skills на самом деле, чем они отличаются от MCP-серверов и сабагентов, как выглядит рабочий SKILL.md, как собрать и установить свой и где взять чужие скиллы, которые не стыдно позаимствовать.
Что такое Claude Code Skills на самом деле?
Skill это директория с файлом SKILL.md. Файл состоит из двух частей: YAML-заголовка (поля name и description) и тела с инструкциями на Markdown. Дополнительно в папку можно положить скрипты, шаблоны или справочники, на которые ссылаются инструкции.
Главный механизм называется ленивая подгрузка (progressive disclosure). Claude не загружает скиллы в контекст заранее. В начале сессии он видит только name и description каждого доступного скилла, это пара десятков токенов на скилл. Запрос совпал с описанием, и Claude читает SKILL.md целиком. Скрипты и файлы, на которые тот ссылается, подтягиваются в последнюю очередь. Выходит три слоя, и каждый подгружается лишь тогда, когда нужен.
Зачем так? Контекст конечен и стоит денег. Если бы в каждую сессию попадали десять скиллов целиком, окно заполняли бы инструкции, не имеющие отношения к текущей задаче. При ленивой подгрузке можно держать установленными хоть пятьдесят скиллов, а токенами платить только за тот, что сработал.
Ещё скиллы не привязаны к модели. Один и тот же SKILL.md работает и на Sonnet, и на Opus, и на Haiku: это обычный текст, а не код под конкретный API. Если направить Claude Code на любой совместимый эндпоинт, скиллы переедут вместе с проектом.
Чем Skills отличаются от MCP-серверов и сабагентов?
Эти три вещи путают постоянно, хотя задачи у них разные.
- Skills несут знание и процедуру: как выполнить задачу, в виде текста, который Claude читает по запросу.
- MCP-серверы дают инструменты и данные: через запущенный процесс они подключают Claude к внешним системам (база, трекер задач, браузер).
- Сабагенты обеспечивают изоляцию: делегированная задача идёт в отдельном окне контекста и не засоряет основной диалог.
Коротко в таблице:
| Skill | MCP-сервер | Сабагент | |
|---|---|---|---|
| Что добавляет | Инструкции / процесс | Инструменты, внешние данные | Отдельный контекст |
| Формат | Папка с SKILL.md | Запущенный сервер (stdio/HTTP) | Конфиг агента + промпт |
| Когда грузится | По запросу (ленивая подгрузка) | Подключается при старте | Создаётся под задачу |
| Нужен код? | Нет | Обычно да | Нет |
| Для чего лучше | Повторяемые процедуры | Живые данные, побочные эффекты | Параллельная или «шумная» работа |
Вместе они работают лучше, чем порознь. Skill может предписать Claude вызвать инструмент MCP-сервера, а затем передать работу сабагенту. Skills это сценарий, MCP экипировка, сабагенты дополнительные руки. Об инструментальной стороне рассказывает статья «MCP-серверы для Claude в 2026».
Как выглядит настоящий SKILL.md?
Пример минимальный, но законченный: skill, который приводит описания пул-реквестов к единому виду.
---
name: pr-description
description: >
Write a pull request description for the current branch. Use when
the user asks to "open a PR", "write a PR description", or
"summarize this branch for review".
---
# PR description
Generate a PR description from the diff against the base branch.
## Steps
1. Run `git diff main...HEAD` to see all changes on the branch.
2. Group changes by intent, not by file.
3. Write the description with these sections:
- **What** — one-paragraph summary of the change.
- **Why** — the problem it solves or the ticket it closes.
- **How to test** — concrete steps a reviewer can run.
- **Risks** — anything that could break, or "none".
4. Keep it under 250 words. No filler. Use present tense.
## Conventions
- Reference issues as `Closes #123`.
- If the diff touches `migrations/`, add a **Migration** note.
- Never include generated lockfile changes in the summary.
Работает он благодаря двум вещам. Первая: description точно говорит, когда применять skill, и перечисляет реальные фразы, которые печатает разработчик. Размытое описание («помогает с PR») срабатывает ненадёжно, а конкретные фразы-триггеры срабатывают. Вторая: тело читается как заметки для онбординга, с нумерованными шагами, жёсткими правилами и краевыми случаями.
В заголовке обязательны только name и description, остальное это инструкции. Писать SKILL.md можно по-английски, даже если сами вы работаете на русском: модель понимает оба языка, а английские фразы-триггеры нередко совпадают с тем, как команды на самом деле формулируют запросы.
Как создать свой skill для Claude Code?
Шагов пять, а полезный skill собирается меньше чем за десять минут.
1. Создайте папку. Скиллы уровня проекта лежат в .claude/skills/, скиллы уровня пользователя (они доступны во всех проектах) в ~/.claude/skills/. Назовите папку по задаче:
mkdir -p .claude/skills/pr-description
2. Напишите SKILL.md с заголовком. Откройте .claude/skills/pr-description/SKILL.md и добавьте YAML-заголовок. Основные силы потратьте на description: это поле решает, сработает ли skill вообще.
3. Напишите инструкции. Под заголовком опишите процесс обычным Markdown. Представьте, что объясняете задачу толковому новичку, который ваших порядков пока не знает.
4. Добавьте скрипты или ресурсы (по желанию). Если нужен шаблон или вспомогательный скрипт, положите его в ту же папку и сошлитесь на него:
Use the template at `./templates/pr-body.md` as the starting structure.
Claude прочтёт этот файл лишь при активации скилла. Снова ленивая подгрузка.
5. Проверьте. Откройте сессию и дайте задачу:
claude
> open a PR for this branch
Если skill подхвачен, Claude пойдёт по вашим шагам. Если нет, скорее всего, description слишком расплывчат или не совпадает с вашей формулировкой запроса. Уточните описание и повторите.
Несколько правил, на которых скиллы работают стабильно:
- Один skill, одна задача. «PR, коммиты и чейнджлоги» в одном файле лучше не смешивать: разбейте на три.
- Триггер в начало. В
descriptionназовите ситуации и фразы, которые должны запускать skill. - Короткое тело. Сфокусированный skill на 30-80 строк надёжнее 300-строчного мануала, через который Claude продирается.
- Версии вместе с репозиторием. Скиллы проекта коммитьте в git, и вся команда получит их сразу.
Как установить и вызвать skill?
Установка сводится к тому, чтобы положить папку в нужное место. Сборки нет, перезапуск сервера не требуется. Положите your-skill/SKILL.md в .claude/skills/ (для этого проекта) или в ~/.claude/skills/ (для всех проектов), и со следующей сессии skill работает.
Вызов чаще всего автоматический. Вы описываете задачу, Claude сверяет её с описаниями скиллов и подгружает подходящий. В этом и смысл устройства: команды запоминать не нужно.
| Уровень | Путь | Доступен в |
|---|---|---|
| Проект | .claude/skills/ | Только этот репозиторий (коммитьте, чтобы делиться) |
| Пользователь | ~/.claude/skills/ | Каждый проект на вашей машине |
| Плагин | поставляется через плагин/маркетплейс | Везде, где установлен плагин |
Между людьми скиллы передают через плагины. Плагин может собрать несколько скиллов (а также команды и агентов) и поставить их одним шагом из маркетплейса. Это слой распространения поверх формата «просто папка».
Где искать лучшие скиллы для Claude Code?
Источников три, ниже они идут примерно по степени отполированности:
- Маркетплейсы плагинов. Курируемые наборы, которые ставятся одной командой. Скиллы в них упакованы вместе с командами и сабагентами, поэтому целый рабочий процесс подключается разом.
- Сборники на GitHub. По запросам «claude code skills» или «everything claude code» находятся репозитории с десятками скиллов: вёрстка фронтенда, ревью кода, документация, тесты, рефакторинг. SKILL.md перед установкой прочитайте, ведь эти инструкции вы отдаёте своему агенту.
- Собственная команда. Лучшие скиллы фиксируют ваши договорённости. Маркетплейс даёт стартовый набор, а главная польза в скиллах, которые кроме вас никто не напишет.
С каких скиллов стоит начать:
- frontend-design: правила по компонентам, отступам, токенам и доступности, чтобы сгенерированный интерфейс попадал в вашу систему.
- code-review: ваш чек-лист ревью, то есть что отмечать, какие бывают уровни критичности и что пропускать.
- doc-writing: тон, структура и примеры, чтобы сгенерированная документация читалась как остальной хендбук.
- testing: договорённости по тестам: фреймворк, нейминг, ожидаемое покрытие, фикстуры.
Одно предостережение. Skill это инструкции, которые вы вручаете автономному агенту, поэтому чужие скиллы воспринимайте как любую зависимость: сначала читайте. Если skill велит Claude выполнять команды в шелле, смотрите на него так же придирчиво, как на любой скрипт.
Запуск Claude Code со Skills из России или любой другой страны
Skills это чистый текст, так что работают они независимо от того, откуда вы запускаете Claude Code. Трудности обычно связаны с оплатой и доступом, а не с самой функцией.
Если аккаунт Anthropic открыть не получается (нет американской карты, нет желания возиться с VPN), доступ к Claude с оплатой по токенам от $0.33 за 1M токенов даёт codexkey. Достаточно направить Claude Code на эндпоинт codexkey, и Skills, MCP-серверы и сабагенты работают так же:
export ANTHROPIC_BASE_URL="https://api.codexkey.ru"
export ANTHROPIC_API_KEY="sk_cdx_yourkeyhere"
Ни аккаунта Anthropic, ни VPN, ни месячного минимума: пополняете баланс, получаете ключ sk_cdx_…, и папка .claude/skills/ ведёт себя так же, как на прямом API. Детали настройки собраны в статьях «Claude Code в России 2026» и «Как настроить Claude Code в 2026». Вопросы можно задать команде в Telegram: https://t.me/codex_key.
Частые вопросы
Skills тратят лишние токены?
Только в момент срабатывания. В начале сессии Claude читает лишь name и description каждого скилла, и это копейки. Весь SKILL.md и файлы по его ссылкам загружаются, когда skill подошёл к задаче. Такая ленивая подгрузка и позволяет держать много скиллов, не раздувая контекст.
Skills это то же самое, что MCP-серверы? Нет. Skills добавляют инструкции, которые Claude читает по запросу, а MCP-серверы добавляют инструменты и живые данные через запущенный процесс. Skill может велеть Claude воспользоваться MCP-инструментом, но слои это разные. Подробнее об инструментах в статье «MCP-серверы для Claude в 2026».
Куда класть skill: на уровень проекта или пользователя?
Командные договорённости кладите в .claude/skills/ и коммитьте, чтобы они дошли до всех. Личные привычки лучше держать в ~/.claude/skills/: они пойдут за вами по всем проектам. Для более широкой раздачи есть плагины.
Почему мой skill не активируется?
Почти всегда виноват description. Claude сверяет с ним ваш запрос, поэтому в описании должны стоять реальные ситуации и фразы-триггеры. Перепишите конкретно («use when the user asks to open a PR»), а не расплывчато («помогает с git»).
Можно ли пользоваться Skills без аккаунта Anthropic?
Можно. Skills относятся к Claude Code, а не к аккаунту. Запустите Claude Code через codexkey с ключом sk_cdx_… (без регистрации в Anthropic и без VPN), и Skills заработают как обычно. Начните с быстрого старта.
Пора собирать
Skills превращают инструкции, которые вы повторяете изо дня в день, в то, что Claude подгружает сам. Напишите один на этой неделе (описание PR, чек-лист ревью, договорённости по тестам), и один и тот же промпт больше не придётся вставлять дважды.
Подключить Claude Code можно по руководству в документации или сразу открыть быстрый старт. Сравнение с редактором Cursor есть в статье «Claude Code или Cursor в 2026», ответы на частые вопросы собраны в FAQ.