Что такое навык агента (SKILL.md) и как проверить чужой

Навык (skill) — это папка с файлом SKILL.md там, где её ищет ваш кодовый агент. Агент читает файл только когда запрос под него подходит. Пока этого не случилось, навык стоит около сотни токенов, а промпт ездит с каждым сообщением, в которое вы его вставили.

Слово «skill» вы, скорее всего, видели в README: «установите навык, потом попросите агента...». Ничего загадочного тут нет. Дальше — что внутри, когда навык попадает в окно контекста и как посмотреть на него до того, как пустить на компьютер.

Что такое навык и чем он отличается от промпта#

Документация Anthropic по Agent Skills (проверено 30 октября 2026) описывает навык как переиспользуемый ресурс на файловой системе: каталог с файлом SKILL.md и, по желанию, скриптами, шаблонами и справочными файлами. SKILL.md начинается с короткого YAML-заголовка (имя и описание), дальше идут обычные инструкции.

Представьте нового коллегу. Промпт — это вы, стоящий за спиной и каждое утро повторяющий правила. Навык — папка на полке с надписью на корешке: «Формат коммитов. Открыть, если просят сделать коммит». Достают её только когда нужно.

Два поля заголовка обязательны, и у формата есть правила. В формате навыков Claude name — не длиннее 64 символов: строчные буквы, цифры и дефисы, и в нём нельзя использовать слова «anthropic» и «claude». description не может быть пустым, ограничено 1 024 символами и должно сказать и что навык делает, и когда его применять.

Как навык попадает в окно контекста#

Документация называет это progressive disclosure, поэтапное раскрытие: агент читает навык в три приёма, и за каждый приём платишь, только если до него дошло.

• Уровень 1, загружается всегда. Имя и описание каждого установленного навыка, около 100 токенов на навык.
• Уровень 2, когда навык сработал. Тело SKILL.md, меньше 5 000 токенов.
• Уровень 3, только при необходимости. Вложенные файлы и скрипты. Когда агент запускает скрипт, код скрипта в контекст не попадает, туда попадает только его вывод.

Числа токенов — приблизительные оценки из документации, а не точный подсчёт.

Вот почему это важно для счёта. Допустим, у вас установлено 20 навыков. 20 × 100 = 2 000 токенов едут с вами с первого сообщения. Агент пересылает контекст на каждом шаге (20-шаговый пример показывает, почему), так что за сессию из 50 шагов набегает 50 × 2 000 = 100 000 входных токенов на ярлыки навыков. На DeepSeek-V4-Flash это $0.0015 по текущим ценам.

Теперь наоборот. Если бы те же двадцать навыков вставили одним большим промптом, каждое тело сидело бы в каждом запросе: до 20 × 5 000 = 100 000 токенов на запрос, а не на сессию. В этой разнице весь смысл загрузки по требованию. Если «окно контекста» пока звучит туманно, этот разбор объясняет, чем оно заполняется.

Навыки живут в контексте, поэтому модели за агентом нужен запас места. У DeepSeek-V4-Flash в CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) контекст 380K и до 32 768 токенов в одном ответе, одна цена в любое время суток и API, совместимый с OpenAI и Anthropic. Для терминального агента — как подключить Claude Code к CheapTokens, для любого другого инструмента начните с документации. Страница самой модели — здесь.

Пишем минимальный навык за две минуты#

Читать проще после того, как написал сам. Этот навык заставляет агента писать сообщения коммитов в фиксированном формате. В Claude Code личные навыки лежат в ~/.claude/skills/, а проектные — в .claude/skills/, так что проектный навык может поехать вместе с репозиторием.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # или любой редактор

Вставьте в файл:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Теперь откройте агента в репозитории с проиндексированными изменениями и попросите: «напиши сообщение коммита для того, что я добавил в индекс». Агент видит описание, решает, что оно подходит, читает четыре правила и следует им. Если навык игнорируется, сначала смотрите на description: в нём должна быть названа ситуация, здесь «commit», теми словами, которыми вы на самом деле просите.

Одна ловушка: навыки не синхронизируются между claude.ai, API и Claude Code. Навык, созданный в одном месте, в другие добавляется отдельно.

Навык, AGENTS.md, MCP: что есть что#

Эти три вещи постоянно путают. Файл правил вроде AGENTS.md или CLAUDE.md читается в начале сессии и хранит факты о проекте (как такой файл подводит в папке «Загрузки»). MCP-сервер даёт агенту новые инструменты и данные, до которых можно дотянуться (MCP простыми словами). Навык — это процедура: как делать один вид работы, и загружается она, когда такая работа появилась.

Как проверить чужой навык перед установкой#

Навык — это текст, которому следует агент, а иногда и код, который агент запускает. Документация советует брать навыки только из надёжных источников, проверять все вложенные файлы (SKILL.md, скрипты, ресурсы) и искать неожиданные сетевые вызовы и обращения к файлам. Навыки, которые подтягивают внешние URL, рискованнее. В Claude Code у навыка тот же доступ к сети, что у любой программы на вашем компьютере, так что установку стоит воспринимать как установку программы.

Хороший образец — universal-modder, набор для модинга игр. Его README (проверено 30 октября 2026) описывает набор навыков в формате Agent Skills под лицензией MIT, Python-утилиту um, MCP-сервер для генерации ассетов через fal и общую базу заметок. Главный навык mod-any-game охватывает разведку, реверс-инжиниринг, генерацию ассетов, тесты в игре и упаковку. README называет поддерживаемыми Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot и OpenCode и пишет, что набор отказывается обходить античит и DRM. В Claude Code он ставится командой /plugin marketplace add rehan-remade/universal-modder, а для генерации ассетов нужен отдельный ключ fal API.

Обратите внимание, что в этом списке: навыки, программа командной строки и сервер. Прочитав один SKILL.md, вы увидите лишь часть того, что устанавливаете. Поэтому проходите по частям:

Главное правило про ключи — в статье как безопасно хранить API-ключ. На странице репозитория дата последнего коммита не видна, поэтому перед тем как на проект полагаться, посмотрите, насколько недавно он обновлялся.