Claude Skills: объяснение трёх уровней прогрессивного раскрытия

Claude Skill физически представляет собой папку. Это не размещённый сервис, не бинарный файл и не блок текста, который вы вставляете в начало беседы, — а каталог, содержащий файл SKILL.md и всё остальное, что нужно для задачи. Практически всё интересное в Skills следует из этого одного решения, потому что папку агент может открывать выборочно. Промпт нельзя открыть выборочно. Он либо есть в беседе, либо нет.

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

Сначала файловая система, затем возможности

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

Результат — это возможность, которая больше любого отдельного файла в папке. Инструкции описывают, как выполнить задачу. Входящий в комплект скрипт может выполнять часть работы, не будучи описанным в прозе. Справочный документ может содержать материал, к которому обращаются, а не который запоминают. Что превращает эти три вещи в систему, а не в кучу, — это порядок, в котором они становятся видимыми; именно эту часть Anthropic называет progressive disclosure — загрузка информации поэтапно по мере необходимости, а не расходование контекста заранее.

Уровень 1: два поля, которые всегда загружаются

Каждый навык начинается с YAML-заголовка (frontmatter), содержащего имя и описание. Claude загружает эти метаданные при запуске и включает их в системный промпт. Это единственная часть навыка, присутствующая до того, как кто-либо о чём-либо попросит, и пока навык не активирован, контекст занимают только его имя и описание.

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

Возьмите две версии одного и того же навыка. В одном описывается заполнение и проверка PDF-форм; его следует использовать, когда запрос связан с заполнением или проверкой PDF-формы. В другом описывается помощь с документами. Первый называет действие и ситуацию; второй не называет ни того, ни другого. Навык, в описании которого не названо ни того, ни другого, будет лежать на диске непрочитанным, пока агент выполняет задачу длинным путём — не потому, что навык не сработал, а потому, что его так и не нашли.

Уровень 2: тело, читаемое при совпадении описания

Когда запрос соответствует описанию, открывается второй уровень: тело SKILL.md. Это процедура — рабочие процессы, передовые практики, рекомендации — и она написана для агента, который уже решил, что этот навык — подходящий инструмент для задачи. Именно здесь команда записывает шаги, которые иначе повторяла бы в каждом разговоре, и именно здесь находятся указатели на более глубокие материалы.

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

Уровень 3: файлы, которые открываются, потому что на них что-то указало

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

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

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

Почему порядок — это дизайн, а не деталь

Из этого следуют три следствия, и вместе они — причина того, что это стоит понимать, а не просто знать.

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

• Описание — это интерфейс. Это единственная часть навыка, которая гарантированно будет увидена, поэтому именно здесь автор должен думать о срабатывании, а не только о содержании.

• У навыка есть три скорости поддержки. Метаданные меняются, когда навык должен срабатывать иначе; тело меняется, когда меняется рабочий процесс; а ссылки меняются, когда меняется лежащий в основе материал. Разделение этих частей не позволяет обновлению ссылки превратиться в переписывание инструкций.

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

Что Anthropic уже выпускает и откуда берутся ваши собственные навыки

Anthropic поставляет готовые Skills для PowerPoint, Excel, Word и PDF — презентации, электронные таблицы, документы и форматированный вывод в PDF. Они доступны на claude.ai, в Claude API, Claude Platform on AWS и Microsoft Foundry, с той оговоркой, что в Foundry для них требуется развертывание Hosted on Anthropic.

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

Пользовательские навыки (Custom Skills) можно создавать в Claude Code, загружать через Claude API или добавлять в настройках claude.ai. Заявленные Anthropic преимущества — те же, которых можно ожидать от любого переиспользуемого компонента: специализация Claude для предметных задач, однократное создание инструкций вместо их повторения и компоновка нескольких навыков для многоэтапной работы. Последнее наиболее прямо следует из архитектуры: если каждый навык — это папка, открываемая по запросу, то набор навыков стоит очень мало, пока работа действительно не потребует их.

Навык — это не промпт и не коннектор.

В разговоре смешиваются три вещи, а порядок загрузки позволяет легко сохранять различия между ними.

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

Коннектор — это про досягаемость. Коннекторы — это доступ к приложениям, а значит, они определяют, к чему агент может дотянуться; навык определяет, как агент должен что-то делать, когда уже может до этого дотянуться. У команды могут быть превосходные коннекторы и при этом она всё равно может выпускать несогласованные документы, потому что доступ — это не процедура. У неё также могут быть превосходные навыки и при этом она всё равно может не видеть данные, потому что процедура — это не доступ.

Документация Anthropic рассматривает Skills и Model Context Protocol как разные уровни, и трёхуровневый механизм показывает, почему это разделение является чистым. Порядок загрузки касается того, когда поступает информация, а не того, откуда она пришла.

Где уместно пожертвование — в одном абзаце

22 октября 2026 года Anthropic передала стандарт Agent Skills фонду Agentic AI Foundation под эгидой Linux Foundation — название, логотип, организацию на GitHub и домен agentskills.io, — а инженеры из Anthropic, Google, OpenAI и других компаний поддерживают его как частные лица. Ничто из этого не меняет описанный выше механизм. Формат папки, YAML-метаданные в начале файла, порядок загрузки и готовые навыки для работы с документами остались в точности такими же, как и днём ранее. Изменилось лишь то, кому принадлежит название; это очень важно для долгосрочной стабильности стандарта и совершенно не влияет на то, как вы напишете навык сегодня днём.

Чтение навыка перед его установкой

Если три уровня — это архитектура, они же образуют и краткий контрольный список для проверки. Сначала прочитайте описание, потому что именно оно решает, произойдёт ли вообще что-либо ещё: в нём должно быть названо, что делает навык и когда его следует использовать, — словами, которые правдоподобно могли бы встретиться в запросе. Вторым прочитайте SKILL.md, потому что это процедура, которой будет следовать агент, и она должна читаться как инструкции для компетентного коллеги, а не как пересказ того, что вы надеетесь получить. Третьим прочитайте то, на что она ссылается. Затем прочитайте скрипты.

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

Об одной границе стоит сказать читателям, которые приходят с наших собственных страниц. OrcaRouter маршрутизирует вызовы моделей, и мы не размещаем ни приложения Anthropic, ни его skill-поверхности — skill выполняется там, где находится файловая система агента, а это не наш уровень. То, что делаем мы, находится ниже выбора модели: более 200 моделей за одним OpenAI-совместимым ключом, списочная цена провайдера передаётся без наценки, и автоматическое переключение между провайдерами, когда один из них недоступен. Skill решает, как должна выполняться задача. Роутер решает, какая модель это делает, и ни одному из уровней не нужно много знать о другом.

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

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