Claude Skills API: что изменилось после GA и как с ним работать

20 августа 2026 года Anthropic перевела Claude Skills API, computer use и Files API в общий доступ. Бета-заголовки больше не нужны, computer use теперь может выполнять несколько действий за один ход, а для веб-задач появился отдельный инструмент browser use. Но ключевой нюанс остался прежним: навык запускается только тогда, когда Claude сам решает его вызвать. Поэтому за продуманную активацию и фиксацию версий по-прежнему отвечаете вы.

Что именно изменилось с выходом GA 20 августа

Существующие интеграции из бета-периода продолжат работать, пока вы переносите их на новую схему. В анонсе запуска Anthropic выделяет несколько практических изменений:

• Бета-заголовки больше не требуются. В актуальном руководстве по Skills указаны лишь два условия: ключ Claude API и включённое выполнение кода в запросе. Заголовки, необходимые в инструкциях до GA, из документации исчезли.
• Несколько действий за один ход. Обновлённый инструмент computer use выполняет за один вызов модели несколько операций — клики, ввод текста, нажатия клавиш и создание скриншотов, — а не одно действие. По данным аккаунта @ClaudeDevs, клиенты раннего доступа сократили число циклов обмена для одной задачи на 20–40%.
• Инструмент browser use. Он объединяет скриншоты со структурой страницы: агент находит конкретное поле или кнопку, а не ориентируется по координатам пикселей. Инструмент рассчитан на веб-порталы, например для подачи страховых заявлений.
• Масштабирование Files API. На организацию доступен 1 ТБ хранилища, лимиты запросов выросли в 5 раз — до 500 RPM, согласно треду @ClaudeDevs, — а срок хранения файлов истекает автоматически.
• Вариант для регулируемых отраслей. Computer use теперь может применяться в нагрузках, подпадающих под HIPAA, в рамках BAA Anthropic.
• Доступность в облаках. Skills API и Files API также доступны через Microsoft Foundry. Обновлённые инструменты computer use и browser use появятся в Vertex AI «в ближайшее время», но без указанной даты.

Как Files API, Skills API и computer use работают вместе

Пример Anthropic со страховым агентом показывает полный цикл: получить документ заявки по ID файла через Files API, применить навык с процедурой оформления через Skills API, заполнить портал страховщика с помощью browser use из computer use, а затем сохранить подтверждение обратно в файл. Документы загружаются один раз и далее передаются по ссылке file_id, а не отправляются заново с каждым запросом.

Оба набора цифр, опубликованные вместе с запуском, предоставлены со стороны вендора. В посте о запуске исследовательский инженер Давиде Локателли сообщил, что самый долгий процесс обработки страхового случая сократился с 32 до 13 минут, а завершение задач достигло 100%. Отдельно Дэвид Млчох, сооснователь Asteroid, тестировал сценарии computer use для здравоохранения в раннем доступе:

«На 32–52% меньше вызовов модели, на 25–32% ниже стоимость задачи, 100% завершения во всех сценариях вместо 77%» — @MlcochDavid

Как подключить Claude Skills API к Messages API

Для подключения навыка нужен один параметр: объект container в запросе Messages API с массивом skills. У каждой записи есть type — anthropic или custom, — skill_id и необязательный version.

Согласно официальному руководству по Skills, вокруг этого параметра есть несколько важных правил:

• Должно быть включено выполнение кода, а модель должна его поддерживать. В примерах руководства используются claude-opus-5, инструмент типа code_execution_20250825 и max_tokens=4096.
• Один запрос поддерживает до 20 навыков.
• Навыки выполняются в песочнице Anthropic для исполнения кода: без доступа к сети, без установки пакетов во время выполнения и в новом контейнере для каждого запроса. Исключение — если вы используете возвращённый container.id между ходами; каждый ответ содержит expires_at.
• Размещать файлы навыков самостоятельно не нужно: Anthropic запускает их внутри контейнера.

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    tools=[{"type": "code_execution_20250825"}],
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "20251013"},
            {"type": "custom", "skill_id": "skill_01...", "version": "skver_01..."},
        ]
    },
    messages=[{"role": "user", "content": "Build the Q3 revenue summary"}],
)

Входные документы передаются в обратном порядке: сначала загрузите их через Files API, затем укажите в блоке загрузки контейнера. Запрос использует стандартную структуру Anthropic Messages API, поэтому работает как с прямым ключом, так и через Anthropic-совместимый прокси, например Claude API от AIReiter.

Встроенные навыки используют короткие понятные ID: pptx, xlsx, docx, pdf. Версии имеют формат даты, например 20251013, либо значение latest. Пользовательские навыки получают ID вида skill_01..., привязанные к вашему workspace.

Свой Skill: требования, из-за которых загрузку отклонят

Пользовательский навык — это каталог, где в корне лежит SKILL.md с YAML-frontmatter, содержащим name и description. Рядом при необходимости размещаются скрипты и справочные файлы. Минимальный рабочий файл выглядит так:

---
name: eu-claims-filing
description: Use when filing or amending EU insurance claims. Loads the
  carrier-specific submission procedure, required fields, and rejection
  codes before filling any portal form.
---

# EU claims filing procedure
1. Pull the intake document by file_id ...

Навык загружается ZIP-архивом или набором отдельных файлов — в Python SDK для этого есть files_from_dir. До запуска Anthropic проверяет жёсткие ограничения, перечисленные в руководстве по Skills:

Управление выполняется через CLI ant или API-эндпоинты, которые он использует, как указано в том же руководстве. Путь от файлов к зафиксированной версии такой:

ant skills create ./eu-claims-filing   # returns skill_01...
ant skills:versions create skill_01...  # returns skver_01... — pin this in production

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

Чек-лист для продакшена: фиксируйте, изолируйте, кэшируйте

В продакшене проблемы обычно создают изменяемые версии, права на уровне workspace и промахи кэша. В руководстве по Skills все три пункта описаны прямо.

1. Фиксируйте версии. Если указать latest или не указывать версию вовсе, любой пользователь с доступом к workspace, загрузивший новую версию, мгновенно изменит поведение вашего развёрнутого агента. В продакшене закрепляйте ID skver_...; latest оставьте для активной разработки.
2. Считайте workspace границей тенанта. Каждый API-ключ внутри workspace может читать, вызывать и удалять все пользовательские навыки. Граница изоляции проходит по workspace, а не по пользователю или сессии. Для мультитенантных приложений нужен отдельный workspace на каждого тенанта; помните и о лимите в 100 workspace по умолчанию.
3. Не меняйте список навыков ради кэша. Изменение списка навыков, включая их порядок, меняет префикс системного промпта и сбрасывает кэш промптов. Закрепление пользовательских версий также защищает этот префикс: иначе повторная загрузка описания для latest его изменит. При оплате за токены плавающий между запросами набор навыков незаметно съедает экономию от попаданий в кэш.
4. Обрабатывайте pause_turn. Длительные навыки возвращают stop_reason: "pause_turn". Чтобы продолжить, отправьте возвращённый контент в следующем запросе; либо измените диалог, чтобы прервать выполнение.
5. Учитывайте политику хранения данных. Agent Skills не входят в соглашения о нулевом хранении данных: определения навыков и данные выполнения регулируются стандартной политикой хранения Anthropic. При включённом Compliance API Activity Feed фиксирует создание и удаление навыков и их версий — только начиная с момента включения.
6. Ловите нужные ошибки. Оборачивайте вызовы обработкой anthropic.BadRequestError и отделяйте ошибки, связанные с навыками, от других ошибок некорректного запроса.
7. Не подключайте неиспользуемые навыки. Документация говорит об этом напрямую: лишние навыки ухудшают производительность.

Главная проблема: навык не обязан запускаться

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

«Моя проблема с Claude Skills в том, что это не навыки. Ничто не заставляет Claude действительно их использовать. Claude делает что хочет... Это просто md-файлы». — @Yampeleg, написано до GA; механизм вызова не изменился

В обсуждении r/ClaudeAI о том, работают ли навыки на практике, сводятся основные способы решить проблему:

«userstyle добавляется перед каждым ходом, а skills срабатывают, только когда claude по описанию решает их вызвать». — u/samxu01

«У Skills должно быть простое и ясное описание в метаданных, сфокусированное на действии, которое выполняет Claude». — u/Chadum

Из этих обсуждений следуют четыре правила:

• Стройте описание вокруг фраз-триггеров и конкретного действия, а не вокруг персоны.
• Шаги, проверки, правила и выбор инструментов размещайте в теле навыка. Проверка u/MartinMystikJonas: «Если ваши skills определяют шаги агента, то, что он должен проверять, правила, которым должен следовать, и инструменты, которыми должен пользоваться, тогда они полезны».
• Кодируйте в навыках то, что Claude плохо делает нативно, как советует u/Actual_Committee4670.
• Требования, которые должны действовать всегда, переносите в системный промпт или CLAUDE.md: они добавляются на каждом ходе, как отмечает u/samxu01. А hooks оставляйте для моментов жизненного цикла — например, перед коммитом.

Короткие ответы

Нужны ли теперь бета-заголовки для Skills API?

Нет. После выхода GA 20 августа 2026 года нужны ключ Claude API и включённое выполнение кода; в актуальной документации бета-заголовки не требуются.

Навыки занимают место в контекстном окне?

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

Чем Skill отличается от MCP?

Skill — это пакет инструкций и скриптов, выполняемый в песочнице Claude без доступа к сети. MCP подключает Claude к работающим внешним системам — именно так Anthropic проводит различие в обзоре Skills. В сценарии со страховым случаем можно использовать оба механизма: MCP-сервер для базы полисов и навык для процедуры оформления.

Можно ли использовать один SKILL.md в Claude.ai, Claude Code и API?

Формат SKILL.md общий, но способ доставки зависит от платформы: навыки, загруженные в workspace, для API; каталоги .claude/skills в Claude Code; и загрузки на уровне плана в приложении Claude.ai.

Работает ли Skills API при zero data retention?

Нет. Agent Skills исключены из соглашений о нулевом хранении данных; для определений навыков и данных выполнения действует стандартная политика хранения.

Что использовать для разных задач

Выбирайте механизм по моменту вызова:

20 августа механизм навыков стал готов к продакшену, но варианты в этой таблице не стали взаимозаменяемыми.

Читайте также: стоимость Claude API по моделям и токенам и запись навыка Claude в Claude Code.