Claude Code — это место, где появились skills, и здесь они раскрываются лучше всего: в этой среде skills могут запускать скрипты с полным доступом к сети, принимать аргументы, работать в собственном субагенте и заменять пользовательские slash-команды, которые у вас уже могут быть. Это руководство посвящено именно стороне Claude Code. Об общем формате и о том, откуда берутся skills, см. Claude skills and agent skills.
Мы изучили документацию Claude Code и справочник команд 14 ноября 2026 года. Список над этим руководством — это все skills в каталоге HostedMCP с командой для установки в Claude Code.
Куда смотрит Claude Code
| Область | Папка | Кому доступен |
|---|---|---|
| Личная | ~/.claude/skills/<name>/SKILL.md |
Вам, в каждом проекте |
| Проектная | .claude/skills/<name>/SKILL.md |
Всем, кто клонирует репозиторий |
| Вложенная | <subfolder>/.claude/skills/<name>/SKILL.md |
Для работы в этой части монорепозитория |
| Плагин | <plugin>/skills/<name>/SKILL.md |
Всем, у кого есть плагин, как /plugin:name |
| Организация | Папка управляемых настроек | Всем в рамках этой политики |
Если у двух навыков совпадает имя, побеждает навык организации, затем ваш, затем проектный. Навыки, включённые на claude.ai, синхронизируются в ~/.claude/skills/synced/.
Создание
mkdir -p .claude/skills/release-notes
Затем напишите .claude/skills/release-notes/SKILL.md:
---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for release notes, a changelog entry or a summary of what shipped.
---
1. List pull requests merged since the last tag with `gh pr list --state merged`.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per change, for users rather than developers.
Это рабочий навык. Claude Code подхватывает его без перезапуска. Попросите подготовить release notes — и он его использует, либо введите /release-notes.
Держите SKILL.md в пределах 500 строк, а объёмные материалы выносите в файлы рядом с ним, на которые ссылаются инструкции. Плагин Anthropic skill-creator, /plugin install skill-creator@claude-plugins-official, позволяет протестировать навык с ним и без него и настроить его описание.
Как это вызывается
| Frontmatter | Можно ввести /name |
Claude использует сам | Описание в контексте |
|---|---|---|---|
| По умолчанию | Да | Да | Всегда |
disable-model-invocation: true |
Да | Нет | Нет |
user-invocable: false |
Нет | Да | Всегда |
/name срабатывает только в начале сообщения, и можно выстроить цепочку до шести штук. Навыки принимают аргументы: $ARGUMENTS в теле заменяется на то, что вы введёте после имени, а argument-hint показывает подсказку в меню.
Есть и другие поля, которые Claude Code добавляет к стандартным: when_to_use для отдельного описания триггера, model и effort, чтобы запустить навык на другой модели или с другим уровнем усилий, allowed-tools и disallowed-tools, а также context: fork, чтобы выполнить навык в субагенте и его работа не забивала основной диалог.
Пользовательские слэш-команды теперь объединены с навыками. И .claude/commands/deploy.md, и .claude/skills/deploy/SKILL.md создают /deploy, а старые файлы команд продолжают работать.
Навыки, которые поставляются с Claude Code
В справочнике команд Claude Code 20 команд помечены как навыки. Вот те, что вы встретите чаще всего:
| Навык | Что делает |
|---|---|
/code-review |
Проверяет diff, ветку или pull request на баги с выбранным вами уровнем тщательности и может исправить или прокомментировать |
/simplify |
Четыре агента проверки ищут проблемы с переиспользованием, упрощением, эффективностью и абстракциями, а затем вносят исправления |
/batch |
Разбивает крупное изменение на 5–30 единиц и запускает по одному фоновому агенту на каждую |
/debug |
Включает отладочное логирование для сессии и читает лог |
/loop |
Повторяет промпт через заданный интервал или подстраивает темп сам |
/run и /verify |
Запускают приложение и проверяют, что изменение действительно работает |
/doctor |
Проверяет установку, настройки, расширения и CLAUDE.md |
/fewer-permission-prompts |
Превращает команды только для чтения, которые вы часто одобряете, в allowlist |
/update-config |
Редактирует settings.json по обычному описанию |
/claude-api |
Загружает актуальный справочник по Claude API и SDK |
/dataviz |
Рекомендации по графикам и дашбордам с валидатором палитры |
/init, который создаёт CLAUDE.md для нового проекта, — это встроенная команда, а не навык, а /review — псевдоним /code-review. Claude Code не поставляется с навыками Anthropic для Word, PDF, PowerPoint и Excel; их нужно установить из репозитория anthropics/skills.
Во что обходятся навыки
Каждый навык, который Claude может вызвать сам, добавляет своё описание в контекст на каждом ходу. Claude Code ограничивает это двумя способами:
- Каждое описание вместе с
when_to_useобрезается в списке до 1 536 символов. - Все описания вместе делят бюджет примерно в 1% контекстного окна модели. Когда он исчерпан, Claude Code отбрасывает описания начиная с самых редко используемых навыков и оставляет только их имена.
После использования содержимое навыка остаётся в разговоре. После автоматического уплотнения контекста последнее использование каждого навыка подключается заново — до 5 000 токенов на навык и до 25 000 в сумме.
/skills показывает ваши навыки и умеет сортировать их по стоимости в токенах; /skill-doctor сообщает, во сколько контекста обходится каждый навык и как часто он используется. Навыку, который вы вызываете только вручную, стоит задать disable-model-invocation: true — тогда его описание полностью убирается из контекста.
Skill, hook, субагент, MCP или плагин
| Нужно | Используйте | Почему |
|---|---|---|
| Факты, которые Claude нужны в каждой сессии | CLAUDE.md | Загружается каждый раз; держите его короче 200 строк |
| Знания для отдельных задач | Skill | Загружается только когда релевантен |
| Что-то, что должно происходить всегда | Hook | Детерминированно, без затрат контекста; «ограничители — в hooks» |
| Тяжёлая работа вне вашего контекста | Субагент | Отдельный контекст, возвращает сводку |
| Инструменты или данные из другой системы | MCP server | Skill может научить Claude пользоваться им |
| Всё перечисленное для команды | Плагин | Упаковывает их в одну установку |
Чаще всего Anthropic описывает связку skill плюс MCP server: сервер даёт инструменты, а skill — понимание, когда и как их применять.
Безопасность
Навыки в Claude Code могут запускать любые скрипты с правами вашего пользователя и с полным доступом к сети. Читайте скрипты любого навыка, который писали не вы. allowed-tools позволяет навыку использовать инструменты, не спрашивая вас; сам по себе он ничего не ограничивает. В проекте просматривайте .claude/skills/ в пул-реквестах так же, как просматриваете код. Организации могут закрыть эту возможность с помощью управляемых настроек, в том числе разрешив только навыки из одобренных маркетплейсов плагинов.
Когда это не работает
| Что вы видите | Причина | Как исправить |
|---|---|---|
| Claude игнорирует навык | Описание не совпадает с вашей формулировкой | Перепишите его; добавьте when_to_use |
/name не найден |
Имя папки и name различаются, либо это новая папка верхнего уровня |
Приведите их в соответствие; выполните /reload-skills |
| У навыка из плагина другое имя | Навыки из плагинов получают пространство имён | Введите /plugin:name |
| Часть навыков потеряла описания | Превышен лимит на список | Удалите неиспользуемые навыки или задайте disable-model-invocation: true |
| Ваш навык перекрыт | Есть навык организации или личный навык с тем же именем | Переименуйте свой |