Навыки

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

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

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

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

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

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

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

ant apply skills/pr-summary

---
name: pr-summary
description: Summarize a pull request's changes and risks in the team's review format.
---

# PR summary

List what changed, why, and anything a reviewer should look at closely, in three short sections.

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

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

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

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

ant apply agent.md

---
name: Financial Analyst
model: claude-opus-5-5
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
---

You are a financial analysis agent.

Загрузка навыков из репозитория 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 = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

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

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

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

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