Навыки Claude Code: как устроен SKILL.md и откуда он загружается

Навыки Claude Code представляют собой папки с файлом SKILL.md внутри. Файл содержит YAML frontmatter, определяющий, когда применяется навык, и основную часть в Markdown с инструкциями. Claude Code постоянно видит описание каждого навыка, загружает полное содержимое только при его использовании и позволяет запустить любой навык вручную командой /skill-name.^[1] Пользовательские slash-команды теперь работают так же: .claude/commands/deploy.md и .claude/skills/deploy/SKILL.md обе создают /deploy, а старые файлы команд продолжают работать.^[1]

Совет Anthropic о том, когда стоит писать навык, практичен. Создайте его, если постоянно вставляете в чат один и тот же чек-лист или процедуру либо если раздел CLAUDE.md превратился из факта в процедуру. CLAUDE.md загружается в каждой сессии; основная часть навыка почти ничего не стоит, пока он не запущен.^[1]

Минимальный навык Claude Code

Навыку нужны каталог и один файл. Этот составляет примечания к выпуску по последним коммитам. Сохраните его как ~/.claude/skills/release-notes/SKILL.md:

---
description: Drafts release notes from recent git commits. Use when the user asks for release notes, a changelog entry, or what shipped.
disable-model-invocation: true
---

## Recent commits

!`git log --oneline -30`

## Instructions

Group the commits above into Added, Changed and Fixed. Write one line per change in plain language. Skip merge commits.

Имя каталога становится командой, поэтому навык запускается через /release-notes. Строка !`...` представляет собой динамическую подстановку контекста: Claude Code выполняет команду и вставляет её вывод в навык до того, как Claude его прочитает, так что примечания основаны на реальной истории.^[1] disable-model-invocation: true запрещает Claude запускать навык самостоятельно, что подходит для всего, что вы хотите запускать сами.

Откуда Claude Code загружает навыки

Выбранная папка определяет, кому доступен навык:^[1]

Расположение	Путь	Кому доступен
Личное	`~/.claude/skills/<name>/SKILL.md`	Вам, в каждом проекте на этой машине
Проектное	`.claude/skills/<name>/SKILL.md`	Всем, кто работает в репозитории, после коммита
Вложенное	`<subdir>/.claude/skills/<name>/SKILL.md`	Сессиям, запущенным в этой папке или ниже
Плагин	`<plugin>/skills/<name>/SKILL.md`	Всем с включённым плагином, как `/plugin-name:skill-name`
Корпоративное	Каталог управляемых настроек	Всем пользователям, для которых организация его развернула
Аккаунт claude.ai	Навыки, включённые в аккаунте	Сессиям с входом в этот аккаунт

Два имени зарезервированы. Claude Code использует ~/.claude/skills/synced/ для навыков, скачанных с claude.ai, и пропускает созданный вами навык с таким именем папки. Вне плагина папка с именем anthropic-skills или начинающимся с anthropic-skills: не загружается.^[1]

Чем управляет frontmatter

Все поля необязательны, а Anthropic рекомендует только description. Claude Code игнорирует неправильно написанное имя поля без сообщения об ошибке, поэтому копируйте имена точно.^[1] Поля, наиболее сильно влияющие на поведение:

description помогает Claude решить, использовать ли навык. Ставьте основной сценарий первым: вместе с when_to_use описание обрезается до 1,536 символов в списке навыков.
disable-model-invocation: true оставляет только ручной запуск. Описание тоже убирается из контекста, поэтому навык ничего не стоит, пока вы не введёте его команду.
user-invocable: false делает обратное: загрузить навык может только Claude, а из меню / он исчезает. Anthropic рекомендует это для фоновых знаний, например об устройстве устаревшей системы.
allowed-tools заранее одобряет инструменты на ход, в котором запускается навык. Разрешение заканчивается, когда вы отправляете следующее сообщение.
paths ограничивает автоматическую загрузку соответствующими файлами, а context: fork запускает навык в субагенте.

model и effort меняют модель и уровень рассуждения до конца хода, не сохраняя изменение в настройках.^[1]

Сколько контекста занимает навык

Anthropic описывает три уровня. Имя и описание каждого навыка загружаются при запуске, около 100 токенов на навык. Основная часть SKILL.md загружается при срабатывании навыка; в таблице Anthropic для этого уровня указано менее 5,000 токенов. Дополнительные файлы ничего не стоят, пока Claude их не прочитает, а код скрипта вообще не попадает в контекст; туда попадает только его вывод.^[2]

После запуска навыка его содержимое остаётся в разговоре одним сообщением, и Claude Code не перечитывает файл на следующих ходах. После автоматического сжатия Claude Code повторно прикрепляет последний запуск каждого навыка, сохраняя первые 5,000 токенов каждого в общем бюджете 25,000 токенов, начиная с самых новых. Если вы использовали много навыков в одной длинной сессии, самые старые могут выпасть.^[1] Правила, которые должны действовать всю задачу, записывайте как постоянные инструкции ближе к началу файла.

Навыки Claude вне Claude Code

Тот же формат работает в других интерфейсах Claude, но правила в каждом свои:^[2]

claude.ai содержит готовые навыки Anthropic для файлов PowerPoint, Excel, Word и PDF, активные без настройки. Пользовательские навыки загружаются как zip-файлы в Settings > Features на тарифах Pro, Max, Ultra, Team и Enterprise с включённым выполнением кода. Каждая загрузка доступна только одному пользователю.
Claude API принимает skill_id в параметре container вместе с инструментом выполнения кода. Готовые идентификаторы: pptx, xlsx, docx и pdf; пользовательские навыки проходят через эндпоинты /v1/skills и доступны всему рабочему пространству.
Claude Code поддерживает пользовательские навыки, но не готовые навыки для документов.

Документация Anthropic противоречит сама себе в вопросе синхронизации. В обзоре Agent Skills сказано, что пользовательские навыки не синхронизируются между интерфейсами, а навыки Claude Code отделены и от claude.ai, и от API.^[2] На более новой странице Claude Code среди источников загрузки для терминальных сессий с входом в аккаунт claude.ai перечислены навыки, включённые в этом аккаунте; они скачиваются в ~/.claude/skills/synced/.^[1] Если вы рассчитываете на синхронизацию, убедитесь, что навык появился в меню /, прежде чем строить на нём рабочий процесс.

Перенос навыка Claude Code в claude.ai или Skills API требует внимания. Эти варианты принимают только шесть полей frontmatter из открытого стандарта Agent Skills: name, description, license, compatibility, metadata и allowed-tools. Любое другое поле, например disable-model-invocation или argument-hint, вызывает отказ загрузки с ошибкой "Unexpected key(s)", а не игнорируется; функции только для Claude Code, такие как подстановка !`command`, там не работают.^[1]^[3] Из примера примечаний к выпуску выше пришлось бы удалить и то и другое.

Установка чужих навыков

Навык может поручить Claude выполнять команды и вызывать инструменты, поэтому Anthropic советует использовать навыки только из доверенных источников и относиться к их установке как к установке программ. Читайте каждый файл в папке, а не только SKILL.md: скрипты, изображения и справочные файлы могут содержать инструкции. Навыки, получающие содержимое с внешних URL, несут дополнительный риск, потому что страница может измениться после вашей проверки.^[2]

FAQ

Навыки Claude Code и slash-команды это одно и то же?

Их объединили. Файл команды в .claude/commands/ и папка навыка с тем же именем создают одну и ту же команду /name. Навыки добавляют вспомогательные файлы, автоматическую загрузку и управление запуском.^[1]

Может ли Claude Code использовать навыки PowerPoint и Excel?

Нет. Готовые навыки Anthropic для документов работают в claude.ai и API, но недоступны в Claude Code. У Claude Code есть собственные встроенные навыки, например /code-review, /debug и /claude-api.^[1]^[2]

Почему Claude игнорирует мой навык?

Сначала проверьте описание: вместе с when_to_use это всё, что Claude видит перед принятием решения. Затем убедитесь, что начальное --- находится на первой строке файла: иначе Claude Code воспринимает frontmatter как обычный текст, а ошибка YAML приводит к загрузке навыка без заданных полей.^[1]

Запуск навыков Claude Code со своим доступом к моделям

Личные и проектные навыки представляют собой файлы на вашей машине, которые читает клиент Claude Code. Если вы подключаете Claude Code к шлюзу вместо подписки Claude, руководство reAPI по Claude Code описывает базовый URL, тип ключа и принимаемые идентификаторы моделей Claude, а страница Claude Sonnet 5.5 показывает текущие ставки. Синхронизация навыков из claude.ai зависит от входа в этот аккаунт, поэтому храните нужные повсюду навыки Claude Code в личных или проектных папках.

Источники

Anthropic. Extend Claude with skills (Claude Code documentation). Дата обращения: 4 ноября 2026, code.claude.com/docs/en/skills
Anthropic. Agent Skills overview. Дата обращения: 4 ноября 2026, platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Agent Skills. Agent Skills open standard. Дата обращения: 4 ноября 2026, agentskills.io