Навыки

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

Вы можете подключить два типа навыков. Оба работают одинаково: ваш агент автоматически вызывает их, когда они релевантны задаче.

• Готовые навыки Anthropic: распространённые задачи по работе с документами, такие как обработка PowerPoint, Excel, Word и PDF (pptx, xlsx, docx, pdf).
• Пользовательские навыки: навыки, которые вы создаёте и загружаете в своё рабочее пространство.

Чтобы узнать, как создавать пользовательские навыки, см. Agent Skills и Лучшие практики создания навыков. Чтобы загрузить пользовательский навык в своё рабочее пространство, см. Создание пользовательского навыка.



Создание пользовательского навыка

Пользовательский навык — это каталог, содержащий файл SKILL.md и любые вспомогательные файлы, загруженный в ваше рабочее пространство в виде zip-архива или отдельных файлов. При создании навыка возвращается идентификатор skill_*, на который вы ссылаетесь при подключении навыка к агенту. Готовые навыки Anthropic уже доступны в каждом рабочем пространстве и не требуют этого шага. Чтобы использовать только готовые навыки, перейдите к разделу Подключение навыков к агенту.

При прямом вызове Skills API через cURL или CLI явно передавайте заголовок anthropic-beta: skills-2025-10-02. SDK отправляют его автоматически.

В этих примерах опущено необязательное поле display_title, поэтому название навыка берётся из SKILL.md. Явно переданное значение display_title должно быть уникальным среди пользовательских навыков в вашем рабочем пространстве.

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

Чтобы просматривать список, получать, удалять и версионировать пользовательские навыки, см. Управление пользовательскими навыками. Полные схемы запросов и ответов см. в справочнике по Create Skill API. Пакеты навыков загружаются напрямую в Skills API, а не через Files API.



Подключение навыков к агенту

Подключайте навыки при создании агента. Каждая сессия поддерживает в общей сложности до 20 навыков, считая по всем агентам в сессии (см. Многоагентные сессии).

Каждая запись в массиве skills использует следующие поля:

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



Дальнейшие шаги