Навыки

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

Навыки попадают к вашему агенту двумя способами: подключите их через массив skills агента или загрузите их из репозитория GitHub, смонтированного в сессии. Подключаемые навыки бывают двух типов. Все навыки работают одинаково: ваш агент вызывает их автоматически, когда они релевантны задаче.

• Готовые навыки 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, а команды beta в 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 < agent.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



Загрузка навыков из репозитория GitHub

Навыки также могут находиться в вашей кодовой базе. Когда сессия монтирует репозиторий через ресурс github_repository, корневой каталог репозитория .claude/skills сканируется при запуске сессии, и каждый найденный там навык становится доступным агенту. Не требуется ни загрузка, ни запись в массиве skills агента. Агент видит имя, описание и путь каждого обнаруженного навыка в песочнице и читает файл SKILL.md навыка, когда задача соответствует ему, включая любые скрипты и ресурсы, поставляемые с навыком. Обнаружение опирается на инструмент агента read из набора инструментов агента, который включён по умолчанию; агент с отключённым read не загружает навыки из репозитория.

Обнаружение находит навыки строго по пути .claude/skills/<skill-name>/SKILL.md, на один уровень каталогов вглубь от корня репозитория:

• your-repo/
  • .claude/
    • skills/
      • code-review/
        • SKILL.md
      • release-process/
        • SKILL.md
        • scripts/
          • run_checks.sh
  • src/

Расположения, не соответствующие этой структуре, не обнаруживаются при запуске сессии:

• .claude/skills/SKILL.md: файл SKILL.md без окружающего его каталога навыка
• .claude/skills/tools/code-review/SKILL.md: вложенность более чем на один уровень каталогов
• skills/code-review/SKILL.md: каталог skills вне .claude

Каталог .claude/skills, расположенный в другом месте репозитория, например внутри подкаталога пакета, не объявляется при запуске сессии; такие навыки всё же могут проявиться, когда агент читает файлы в этом поддереве.

Навыки из репозитория используют тот же формат SKILL.md, что и загружаемые вами пользовательские навыки. Формат и рекомендации по созданию см. в Agent Skills и Лучших практиках создания навыков.

Чтобы загрузить навыки из репозитория, создайте сессию, которая его монтирует. Это тот же запрос, что показан в разделе Доступ к GitHub; параметр mount_path необязателен и по умолчанию равен /workspace/<repo-name>:

SESSION_ID=$(ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID" \
  --transform id --raw-output <<'EOF'
resources:
  - type: github_repository
    url: https://github.com/org/repo
    mount_path: /workspace/repo
    authorization_token: ghp_your_github_token
EOF
)

Для приватных репозиториев authorization_token ресурса должен иметь доступ к репозиторию. Это тот же процесс с персональным токеном доступа, который используется для любого монтирования репозитория; см. Доступ к GitHub.

Обнаруженные навыки соответствуют извлечённому состоянию репозитория: ветке или коммиту checkout, если ресурс их задаёт, иначе — ветке репозитория по умолчанию. Сканирование выполняется один раз, при запуске сессии. Коммиты, отправленные в ходе сессии, не подхватываются; чтобы загрузить обновлённые навыки, запустите новую сессию.

Навыки из репозитория работают вместе с навыками, подключёнными через массив skills агента. Если навык из репозитория имеет то же имя, что и подключённый навык или навык из другого смонтированного репозитория, доступны оба; каждый объявляется со своим собственным путём.



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