Навыки

«Skills» (навыки) — это переиспользуемые ресурсы на основе файловой системы, которые дают вашему агенту предметно-ориентированную экспертизу: рабочие процессы, контекст и лучшие практики, превращающие агента общего назначения в специалиста. Каждый добавленный навык влечёт небольшие затраты в контекстном окне сессии, добавляя инструкции и метаданные, которые помогают модели использовать навык. Узнайте больше в обзоре Agent Skills.

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

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

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



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

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

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

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

ant beta:skills create \
  --file example_skill.zip

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



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

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

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

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



Следующие шаги