Claude Platform Docs
Управляемые агентыОпределение агента

Навыки

Подключайте готовые или пользовательские навыки к агенту в Claude Managed Agents, чтобы дать ему многократно используемую экспертизу на основе файловой системы для рабочих процессов в конкретных предметных областях.

«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
skills/pr-summary/SKILL.md
---
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.

ant apply загружает каталог skills/pr-summary, выводит идентификатор нового навыка и записывает его в claude-lock.json. Зафиксируйте claude-lock.json в коммите, чтобы следующий запуск ant apply загрузил ваши правки как новую версию, а не создал второй навык.

Чтобы получать список, извлекать, удалять и версионировать пользовательские навыки, см. Управление пользовательскими навыками. Полные схемы запросов и ответов см. в справочнике API Создать навыкДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. Пакеты навыков загружаются напрямую в Skills API, а не через Files API.

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

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

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

ПолеОписание
typeЛибо anthropic для готовых навыков, либо custom для навыков, созданных в рабочем пространстве.
skill_idИдентификатор навыка. Для навыков Anthropic используйте короткое имя (например, xlsx). Для пользовательских навыков используйте идентификатор skill_*, возвращённый при создании (см. Создание пользовательского навыка).
versionЗакрепите конкретную версию или используйте latest. Необязательное. По умолчанию latest, если опущено. Применяется как к навыкам Anthropic, так и к пользовательским навыкам.
ant apply agent.md
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 ресурса должен иметь доступ к репозиторию. Это тот же процесс с персональным токеном доступа, который используется для монтирования любого репозитория; см. Разрешения токена.

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

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

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

Настраивайте облачные песочницы для своих сессий.

Узнайте, как использовать Agent Skills для расширения возможностей Claude через API.

Загружайте файлы один раз и ссылайтесь на них в разных запросах API.

Узнайте, как использовать Agent Skills для создания документов с помощью Claude API менее чем за 10 минут.

Эта страница была полезной?