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, и только потом подтягивает скрипты или файлы, на которые тот ссылается. Три слоя, каждый грузится по необходимости.
Зачем так? Контекст конечен и недёшев. Если бы Claude загружал десять полных скиллов в каждую сессию, окно забивалось бы инструкциями, которые к текущей задаче не относятся. Ленивая подгрузка позволяет держать установленными хоть пятьдесят скиллов и платить токенами только за тот, что сработал.
Skills ещё и переносимы между моделями. Один и тот же 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 — снаряжение, сабагенты — дополнительные руки. Про инструментальную часть — в /blog/mcp-servers-claude-guide.
Как выглядит настоящий 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?
Пять шагов. Полезный скилл собирается меньше чем за десять минут.
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 прочитает этот файл только когда skill активируется — снова ленивая подгрузка.
5. Проверьте. Запустите сессию и дайте задачу:
claude
> open a PR for this branch
Если Claude подхватил skill, вы увидите, что он идёт по вашим шагам. Если нет — скорее всего, description слишком расплывчат или не совпадает с тем, как вы сформулировали запрос. Уточните и повторите.
Несколько правил, чтобы скиллы работали стабильно:
- Один skill — одна задача. Не суйте «PR, коммиты и чейнджлоги» в один файл. Разбейте.
- Триггер — вперёд. В
descriptionназовите ситуации и фразы, которые должны его активировать. - Держите тело коротким. Сфокусированный skill в 30–80 строк лучше 300-строчного мануала, через который Claude продирается.
- Версионируйте вместе с репозиторием. Коммитьте проектные скиллы в git, чтобы их получила вся команда.
Как установить и вызвать skill?
Установка — это просто положить папку в нужное место. Без сборки, без перезапуска сервера. Кидаете your-skill/SKILL.md в .claude/skills/ (этот проект) или ~/.claude/skills/ (все проекты) — и со следующей сессии он активен.
Вызов чаще всего автоматический. Вы описываете задачу, Claude сопоставляет её с описаниями скиллов и подгружает подходящий. В этом весь смысл устройства — не нужно запоминать команды.
| Уровень | Путь | Доступен в |
|---|---|---|
| Проект | .claude/skills/ | Только этот репозиторий (коммитьте, чтобы делиться) |
| Пользователь | ~/.claude/skills/ | Каждый проект на вашей машине |
| Плагин | поставляется через плагин/маркетплейс | Везде, где установлен плагин |
Плагины — это способ передавать скиллы между людьми. Плагин может собрать несколько скиллов (плюс команды и агентов) и установить их одним шагом из маркетплейса. Это слой дистрибуции поверх формата «просто папка».
Где искать лучшие скиллы для Claude Code?
Три источника, примерно по степени отполированности:
- Маркетплейсы плагинов. Курируемые наборы, которые ставятся одной командой. Они упаковывают скиллы вместе с командами и сабагентами — целый процесс заезжает разом.
- Сборники на GitHub. Поищите «claude code skills» или «everything claude code» — найдёте репозитории с десятками скиллов: вёрстка фронтенда, ревью кода, написание документации, тесты, рефакторинг. Прочитайте SKILL.md перед установкой: вы отдаёте эти инструкции своему агенту.
- Ваша собственная команда. Лучшие скиллы — те, что кодируют ваши договорённости. Маркетплейсы дают стартовый набор, а настоящая польза — в скиллах, которые никто, кроме вас, не напишет.
Скиллы, которые стоит завести первыми:
- frontend-design — правила по компонентам, отступам, токенам и доступности, чтобы сгенерированный UI попадал в вашу систему.
- code-review — ваш чек-лист ревью как skill: что отмечать, уровни критичности, что игнорировать.
- doc-writing — тон, структура и примеры, чтобы сгенерированная документация читалась как остальной хендбук.
- testing — ваши договорённости по тестам: фреймворк, нейминг, ожидаемое покрытие, фикстуры.
Одно предостережение: skill — это инструкции, которые вы вручаете автономному агенту. Относитесь к чужим скиллам как к любой зависимости — сначала читайте. Skill, который велит Claude выполнять команды в шелле, заслуживает той же придирчивости, что и любой скрипт.
Запуск Claude Code + Skills из России и не только
Skills — чистый текст, поэтому работают независимо от того, откуда вы запускаете Claude Code. Трение обычно в оплате и доступе, а не в самой функции.
Если открыть аккаунт Anthropic не выходит — нет карты США, нет желания возиться с VPN — Claudexia даёт доступ к Claude с оплатой по токенам от $0.33 за 1M токенов. Направьте Claude Code на эндпоинт Claudexia, и Skills, MCP-серверы и сабагенты заработают так же:
export ANTHROPIC_BASE_URL="https://api.claudexia.tech"
export ANTHROPIC_API_KEY="sk_cdx_yourkeyhere"
Без аккаунта Anthropic, без VPN, без месячного минимума — пополнили, получили ключ sk_cdx_…, и папка .claude/skills/ ведёт себя ровно так же, как на прямом API. Детали настройки: /blog/claude-code-russia-setup и полный гайд /blog/claude-code-setup-guide.
Частые вопросы
Skills тратят лишние токены?
Только когда срабатывают. В начале сессии Claude читает лишь name и description каждого скилла — это копейки. Полный SKILL.md и файлы, на которые он ссылается, грузятся, только когда skill совпал с задачей. Это и есть ленивая подгрузка, поэтому много установленных скиллов не раздувают контекст.
Skills — это то же, что MCP-серверы? Нет. Skills добавляют инструкции, которые Claude читает по запросу; MCP-серверы добавляют инструменты и живые данные через запущенный процесс. Skill может велеть Claude использовать MCP-инструмент, но это разные слои. Подробнее про инструменты — /blog/mcp-servers-claude-guide.
Куда класть 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 через Claudexia с ключом sk_cdx_… — без регистрации в Anthropic и без VPN — и Skills будут работать как обычно. Начните с /docs/quickstart.
Пора собирать
Skills превращают инструкции, которые вы повторяете изо дня в день, в то, что Claude подгружает сам. Напишите один на этой неделе — описание PR, чек-лист ревью, ваши договорённости по тестам — и перестанете вставлять один и тот же промпт дважды.
Подключите Claude Code по гайду /docs/guides/claude-code или сразу переходите к /docs/quickstart. Сравнения — в /blog/claude-code-vs-cursor-2026, частые вопросы — в /docs/faq.