Начало работы с Agent Skills в API

В этом руководстве показано, как использовать Agent Skills (навыки агента) для создания презентации PowerPoint. Вы узнаете, как включить навыки (Skills), выполнить запрос и получить доступ к созданному файлу.

Предварительные требования

• Ключ API Claude или выполненный вход в ant CLI
• Клиентский SDK для вашего языка либо curl и jq
• Базовое знакомство с выполнением запросов к API

Обзор Agent Skills

Готовые Agent Skills расширяют возможности Claude специализированной экспертизой для таких задач, как создание документов, анализ данных и обработка файлов. Anthropic предоставляет в API следующие готовые Agent Skills:

• PowerPoint (pptx): создание и редактирование презентаций
• Excel (xlsx): создание и анализ электронных таблиц
• Word (docx): создание и редактирование документов
• PDF (pdf): генерация PDF-документов

Шаг 1: Получите список доступных навыков

Сначала проверьте, какие навыки доступны. Используйте Skills API, чтобы получить список всех навыков, управляемых Anthropic. Каждая языковая вкладка представляет собой фрагмент одного непрерывного скрипта, в начале которого находятся все импорты и настройка клиента:

# Список Skills, управляемых Anthropic
skills = client.skills.list(source="anthropic")

for skill in skills.data:
    print(f"{skill.id}: {skill.display_name}")

Вы увидите следующие навыки: pptx, xlsx, docx и pdf.

Этот API возвращает метаданные каждого навыка: его имя и описание. Claude загружает эти метаданные при запуске, чтобы определить, какие навыки доступны. Это первый уровень progressive disclosure (постепенного раскрытия), на котором Claude обнаруживает навыки, пока не загружая их полные инструкции.

Шаг 2: Создайте презентацию

Используйте навык PowerPoint, чтобы создать презентацию о возобновляемой энергетике. Укажите навыки с помощью параметра container в Messages API:

# Создаём сообщение с PowerPoint Skill
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a presentation about renewable energy with 5 slides",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

Запрос включает следующие части:

• model: модель, поддерживающая инструмент выполнения кода
• container.skills: указывает, какие навыки может использовать Claude
• type: "anthropic": указывает, что это навык, управляемый Anthropic
• skill_id: "pptx": идентификатор навыка PowerPoint
• version: "latest": версия навыка, установленная на последнюю опубликованную
• tools: включает выполнение кода (обязательно для навыков)

Когда вы выполняете этот запрос, Claude автоматически сопоставляет вашу задачу с подходящим навыком. Поскольку вы запросили презентацию, Claude определяет, что навык PowerPoint подходит, и загружает его полные инструкции: это второй уровень постепенного раскрытия. Затем Claude запускает код навыка, чтобы создать вашу презентацию.

Шаг 3: Скачайте созданный файл

Презентация была создана в контейнере выполнения кода и сохранена как файл. response из шага 2 содержит ссылку на файл с идентификатором файла. Извлеките идентификатор файла и скачайте файл с помощью Files API. В примере он сохраняется во временный каталог вашей системы:

# Извлекаем ID файла. Инструмент выполнения кода запускает код Skill через
# свой подинструмент Bash, а созданные файлы появляются как bash_code_execution_output
# внутри блока bash_code_execution_tool_result.
file_id = None
for block in response.content:
    if block.type == "bash_code_execution_tool_result":
        if block.content.type == "bash_code_execution_result":
            for output in block.content.content:
                file_id = output.file_id

if file_id:
    # Скачиваем файл и сохраняем его
    output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
    file_content = client.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Попробуйте другие примеры

Попробуйте эти варианты:

Создание электронной таблицы

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a quarterly sales tracking spreadsheet with sample data",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Создание документа Word

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Write a 2-page report on the benefits of renewable energy",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Генерация PDF

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Generate a PDF invoice template",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

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