Claude Code skills: как устроен навык и как сделать свой

Claude Code читает проект, правит файлы и запускает команды, а навык добавляет ему постоянное умение, которое он берёт сам, когда оно понадобилось. Здесь разобрано, из чего навык состоит, где он хранится, чем отличается от сервера MCP и как выглядит навык, который рисует картинки для проекта.

Как устроен навык: каталог и файл SKILL.md

Навык — это каталог, внутри которого лежит файл SKILL.md. Устройство этого файла Anthropic описывает на странице «Расширьте Claude с помощью skills», и в английской версии той же страницы Extend Claude with skills сказано так: «Every skill needs a SKILL.md file with two parts: YAML frontmatter between --- markers that tells Claude when to use the skill, and markdown content with the instructions Claude follows when the skill runs». Перевод наш: «Каждому навыку нужен файл SKILL.md из двух частей: заголовок YAML между строками ---, который говорит Claude, когда навык применять, и текст в формате markdown с указаниями, которым Claude следует при работе навыка». Сама программа ставится одной командой, и порядок установки под каждую систему разобран в статье как установить Claude Code.

Полей в заголовке два десятка, и заполнять их все не требуется. Anthropic пишет об этом в разделе про заголовок на той же странице: «All fields are optional. Only description is recommended so Claude knows when to use the skill». Перевод наш: «Все поля необязательны. Рекомендуется только description, чтобы Claude знал, когда применять навык». Из остальных полей чаще прочих берут name, disable-model-invocation и allowed-tools.

Отсюда виден и способ сделать свой навык под задачу. Вы заводите каталог с именем навыка, кладёте в него SKILL.md, в заголовке называете навык и описываете, для какого случая он нужен, а дальше обычными словами записываете порядок работы — тот самый, который иначе пришлось бы повторять агенту в каждом новом разговоре. Никакого особого языка для второй части файла не предусмотрено: это текст с указаниями, написанный так же, как вы объясняли бы задачу человеку.

Повод завести навык Anthropic называет прямо: «Create a skill when you keep pasting the same instructions, checklist, or multi-step procedure into chat, or when a section of CLAUDE.md has grown into a procedure rather than a fact». Перевод наш: «Заводите навык, когда вы снова и снова вставляете в разговор одни и те же указания, проверочный список или многошаговый порядок работы, либо когда раздел CLAUDE.md разросся из факта в процедуру».

Где хранятся скиллы Claude Code и кому они доступны

Место каталога задаёт область видимости навыка — то есть круг проектов, в которых Claude его увидит. Про личный путь ~/.claude/skills/<имя>/SKILL.md в таблице мест хранения сказано: «All your projects on this machine, but not Cowork or cloud sessions». Перевод наш: «Во всех ваших проектах на этой машине, но не в сеансах Cowork и не в облачных сеансах». Про проектный путь .claude/skills/<имя>/SKILL.md там же: «Sessions in this repository. Commit it so your team gets it too». Перевод наш: «В сеансах этого репозитория. Закоммитьте его, чтобы он достался и вашей команде». Кроме них Anthropic называет ещё два уровня: уровень плагина и уровень организации.

Имена навыков на разных уровнях могут совпасть, и на этот случай задан порядок старшинства. Anthropic записывает его в таблицу совпадающих имён: «Enterprise over personal, and personal over project. With deploy in both ~/.claude/skills/ and the project’s .claude/skills/, /deploy runs the personal one». Перевод наш: «Организация старше личного, личный старше проектного. Если deploy лежит и в ~/.claude/skills/, и в проектном .claude/skills/, команда /deploy запустит личный». Когда навык ведёт себя не так, как записано в проектном файле, первым делом смотрят, нет ли навыка с тем же именем в домашнем каталоге.

Как навык срабатывает у агента Claude Code

Сработать навык может двумя путями, и оба названы в первой же фразе страницы про навыки: «Skills extend what Claude can do. Create a SKILL.md file with instructions, and Claude adds it to its toolkit. Claude uses skills when relevant, or you can invoke one directly with /skill-name». Перевод наш: «Навыки расширяют то, что Claude умеет. Создайте файл SKILL.md с указаниями, и Claude добавит его в свой набор инструментов. Claude применяет навыки, когда они уместны, либо вы вызываете навык напрямую через /имя-навыка». В примере Anthropic такая команда выглядит как /summarize-changes.

За первый путь отвечает поле description. Именно по нему Claude решает, подходит ли навык к тому, о чём сейчас идёт речь, поэтому в описании называют и тему навыка, и случай, в котором он нужен. Длина описания при этом ограничена: в перечне навыков текст description вместе с when_to_use обрезается на 1 536 знаках. Ручной вызов по имени остаётся рядом на те разы, когда навык нужен прямо сейчас, а разговор идёт про другое. Так агенты Claude Code и держат сразу несколько навыков: каждый со своим описанием и своим именем для вызова. Куда такой вызов встраивается в обычный ход работы, видно в разборе одного сеанса от первого вопроса до проверки.

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

Разница видна по тому, как каждый из них появляется в работе. На странице Extend Claude Code, где Anthropic сводит все способы расширения в один перечень, эти две строки стоят рядом: «Skills add reusable knowledge and invocable workflows» и «MCP connects Claude to external services and tools». Перевод наш: «Навыки добавляют переиспользуемое знание и порядки работы, которые можно вызвать» и «MCP подключает Claude к внешним службам и инструментам».

Навык — это файлы: каталог и текст внутри проекта или домашнего каталога. Сервер MCP подключается отдельной командой, и запись о нём попадает в файл настроек. Выглядит команда добавления так:

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

У этой записи тоже есть область видимости, и по умолчанию это local: сервер доступен только вам и только в текущем проекте. Ключ --scope user добавляет сервер один раз для всех ваших проектов, ключ --scope project делает запись общей с командой. Область задаётся при добавлении и на месте не меняется: чтобы её сменить, сервер удаляют командой claude mcp remove <имя> --scope local и добавляют заново с нужной областью. Что подключено сейчас, внутри разговора показывает команда /mcp, а рядом с ней работают claude mcp list и claude mcp get <имя>. Весь порядок подключения Anthropic описывает на странице «Подключение к серверам MCP».

Цитаты выше сняты со страниц документации Anthropic 15 сентября 2026 года.

GEN202 даёт агенту навык. Как сервер добавляют, где хранится запись о нём и кому он виден, разобрано в статье про MCP-серверы для Claude Code. Подключается навык тем же способом, каким вы ставите агенту любую другую задачу: одной фразой словами, после которой агент сам читает описание и настраивает вызовы.

Навыки глазами тех, кто собрал из них систему

Устройство навыка описано у Anthropic, а во что оно превращается на большом проекте, видно по разборам практиков. В статье «Как я собрал систему из девяти скиллов для Claude Code, которая не разваливается на длинных» от 20 июля 2026 года автор под именем ShyDamn начинает с наблюдения: «У любого агента, которому даёшь большую задачу, есть общая болезнь: чем длиннее контекст, тем хуже он держит собственные правила».

Устройство навыка он пересказывает так: «Скилл в Claude Code — это папка с файлом SKILL.md, у которого во фронтматтере есть name и description. Агент видит только description всех доступных скиллов, и когда задача под него подходит — подгружает тело скилла в контекст». Из этого он и выводит свой порядок: девять навыков вместо одного большого, а подробности вынесены в отдельные файлы рядом с навыком — у навыка про движение это SKILL.md плюс семь файлов в каталоге references/.

Практический вывод для вашего первого навыка простой. Описание пишут коротко и точно по теме, а длинные подробности выносят в соседние файлы, на которые навык ссылается. Тогда в разговор попадает ровно то, что нужно текущему шагу.

Навык, который рисует картинки для проекта

В работе над проектом изображение нужно регулярно: заставка для README, кадр для лендинга, значок, картинка для карточки товара. Claude Code читает проект и правит файлы, а рисование остаётся за отдельными моделями — и это ровно тот случай, под который заводят навык.

Подключение — одна фраза, которую вы даёте своему агенту:

«Прочитай https://gen202.com/skill и настрой по этому описанию вызовы GEN202 API — генерацию и правку изображений. Ключ возьми из переменной окружения GEN202_KEY; если её нет — проведи меня по подключению по тому же описанию».

Дальше агент работает сам. Он открывает описание навыка — отдельную страницу с порядком вызовов: как задача уходит на генерацию и откуда потом берётся результат, — и сохраняет этот порядок у себя, там, где его инструмент держит постоянные указания.

После подключения агент рисует картинку по описанию словами, переделывает присланное изображение, подбирает форму кадра и разрешение под то место, куда картинка встанет, и забирает готовый файл по ссылке. Ссылка живёт четырнадцать суток, поэтому файл имеет смысл сразу сохранить в проект.

За навыком стоят модели Nano Banana 2, Nano Banana Pro, GPT Image 2 и Grok Imagine Image 2.0 — те же, что в таблице цен на странице генерации изображений из Claude Code. Выбор между ними агент делает сам по задаче, которую вы ему назвали.

Что проверить после подключения

Проверка занимает одну картинку. Дайте агенту простую задачу на картинку и посмотрите, как он её выполняет.

1. Попросите простое изображение в невысоком разрешении: на этом шаге нужен сам готовый файл, а красота кадра подождёт.
2. Дождитесь номера задачи. Первым запросом агент ставит задачу на генерацию, а само изображение забирает вторым шагом.
3. Откройте пришедшую ссылку сами и убедитесь, что файл открывается и сохранён туда, куда вы просили.
4. Загляните в кабинет, в логи запросов: у каждого обращения там стоит своя стоимость, и по ней видно, что счёт идёт за ваши задачи.
5. Начните новый разговор и попросите картинку снова.

Последний шаг здесь главный: он отделяет разовое выполнение просьбы от настоящего навыка. Описание агент читает один раз, а дальше берёт сохранённый порядок сам — так же, как берёт любой другой навык из своего каталога.

Частые вопросы

Чем навык отличается от команды? Команда — это ручной вызов по имени: вы набираете её в разговоре, и Claude выполняет то, что записано в навыке; в примере Anthropic такая команда выглядит как /summarize-changes. Навык шире: это каталог с файлом SKILL.md, где и лежит содержание работы, и Claude обращается к нему ещё и сам, когда разговор пошёл про его тему. Узнаёт он тему по полю description в заголовке файла, а его длина в перечне навыков ограничена 1 536 знаками вместе с полем when_to_use, поэтому описание пишут коротко.

Где хранить навык, если он нужен всей команде? Общий для команды навык кладут на проектный уровень — в .claude/skills/<имя>/SKILL.md, и тогда он работает в этом проекте. Личный каталог ~/.claude/skills/<имя>/SKILL.md остаётся вашим и работает во всех ваших проектах сразу, но в сеансах Cowork и в облачных сеансах он не читается. Имена на двух уровнях стоит развести: при совпадении личный навык перекрывает проектный, и человек со своим одноимённым навыком получит собственное поведение вместо общего. Кроме этих двух уровней Anthropic называет уровень плагина и уровень организации, причём организация в порядке старшинства стоит выше всех.

Можно ли тем же навыком пользоваться в Codex? Фраза подключения — обычная просьба словами, а не команда одного инструмента, поэтому её даёт своему агенту тот, кто с ним работает: и в Claude Code, и в Codex. Anthropic отдельно отмечает, что формат навыка задан открытым стандартом Agent Skills, «which works across multiple AI tools» — перевод наш: «который работает в нескольких инструментах на основе ИИ». Описание вызовов открыто по адресу /skill отдельной страницей, агент читает его и настраивает обращения своими средствами. Различается только то, где хранится сам файл навыка: каталоги ~/.claude/skills и .claude/skills вместе с полями заголовка SKILL.md — это устройство Claude Code, а другой инструмент держит постоянные указания по своим правилам.

Сколько стоит картинка? Цена зависит от модели и от разрешения, которое агент поставил задаче. В невысоком разрешении на Nano Banana 2 готовая картинка обходится в 7,2 ₽, на Nano Banana Pro в высоком — 21,6 ₽. Поэтому черновые кадры делают в низком разрешении, а высокое ставят на том, который пойдёт в проект. Все модели навыка со своими ставками собраны в таблице цен на странице генерации изображений из Claude Code.