APIでAgent Skillsを使い始める

このチュートリアルでは、Agent Skillsを使用してPowerPointプレゼンテーションを作成する方法を説明します。Skillsを有効にする方法、簡単なリクエストを行う方法、生成されたファイルにアクセスする方法を学びます。

前提条件

Claude APIキー
Python 3.7以上またはcurlがインストールされていること
APIリクエストの基本的な知識

Agent Skillsの概要

事前構築されたAgent Skillsは、ドキュメントの作成、データの分析、ファイルの処理などのタスクに特化した専門知識でClaudeの機能を拡張します。Anthropicは、APIで以下の事前構築されたAgent Skillsを提供しています。

PowerPoint (pptx)： プレゼンテーションの作成と編集
Excel (xlsx)： スプレッドシートの作成と分析
Word (docx)： ドキュメントの作成と編集
PDF (pdf)： PDFドキュメントの生成

カスタムSkillsを作成したいですか？ ドメイン固有の専門知識を持つ独自のSkillsを構築する例については、Agent Skills Cookbookを参照してください。

ステップ1：利用可能なSkillsを一覧表示する

まず、どのSkillsが利用可能かを確認します。Skills APIを使用して、Anthropicが管理するすべてのSkillsを一覧表示します。

次のSkillsが表示されます：pptx、xlsx、docx、pdf。

このAPIは各Skillのメタデータ（名前と説明）を返します。Claudeは起動時にこのメタデータを読み込み、どのSkillsが利用可能かを把握します。これは「progressive disclosure」（段階的開示）の第1レベルであり、Claudeは完全な指示をまだ読み込まずにSkillsを発見します。

ステップ2：プレゼンテーションを作成する

次に、PowerPoint Skillを使用して再生可能エネルギーに関するプレゼンテーションを作成します。Messages APIのcontainerパラメータを使用してSkillsを指定します。

各部分の役割を説明します。

container.skills： Claudeが使用できるSkillsを指定します
type: "anthropic"： これがAnthropic管理のSkillであることを示します
skill_id: "pptx"： PowerPoint Skillの識別子
version: "latest"： 最新の公開バージョンに設定されたSkillバージョン
tools： コード実行を有効にします（Skillsに必須）
ベータヘッダー： code-execution-2025-08-25とskills-2025-10-02

ここでの例では、code_execution_20250825ツールバージョンと、それに対応するcode-execution-2025-08-25ベータヘッダーを使用しています。Skillsは、より新しいコード実行ツールのリビジョン（code_execution_20260120以降）でも動作します。どのコード実行ツールバージョンでもSkillsの要件を満たします。どのバージョンを使用する場合でも、ツールのtypeとベータヘッダーをコード実行ツールのページと一致させ、常にskills-2025-10-02を含めてください。

このリクエストを行うと、Claudeは自動的にタスクを関連するSkillにマッチングします。プレゼンテーションを依頼したため、ClaudeはPowerPoint Skillが関連していると判断し、その完全な指示を読み込みます。これが段階的開示の第2レベルです。その後、ClaudeはSkillのコードを実行してプレゼンテーションを作成します。

ステップ3：作成されたファイルをダウンロードする

プレゼンテーションはコード実行コンテナ内で作成され、ファイルとして保存されました。レスポンスにはファイルIDを含むファイル参照が含まれています。ファイルIDを抽出し、Files APIを使用してダウンロードします。

生成されたファイルの操作に関する詳細については、コード実行ツールのドキュメントを参照してください。

その他の例を試す

Skillsを使用して最初のドキュメントを作成したので、次のバリエーションを試してみてください。

スプレッドシートを作成する

Wordドキュメントを作成する

PDFを生成する

次のステップ

事前構築されたAgent Skillsを使用したので、次のことができます。

APIガイド

Claude APIでSkillsを使用する

カスタムSkillsを作成する

特殊なタスク用に独自のSkillsをアップロードする

作成ガイド

効果的なSkillsを作成するためのベストプラクティスを学ぶ

Claude CodeでSkillsを使用する

# PowerPoint Skillを使用してメッセージを作成
response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "skills-2025-10-02"],
    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_20250825", "name": "code_execution"}],
)

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

# コード実行ツールの結果からファイルIDを抽出。Skillは
# Pythonまたはbashのコード実行ツールのいずれかで処理を実行する可能性があるため、
# 両方の結果タイプを確認します。
file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif 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.beta.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "skills-2025-10-02"],
    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_20250825", "name": "code_execution"}],
)

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "skills-2025-10-02"],
    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_20250825", "name": "code_execution"}],
)

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    betas=["code-execution-2025-08-25", "skills-2025-10-02"],
    container={
        "skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Generate a PDF invoice template",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

前提条件

Agent Skillsの概要

ステップ1：利用可能なSkillsを一覧表示する

ステップ2：プレゼンテーションを作成する

ステップ3：作成されたファイルをダウンロードする

その他の例を試す

スプレッドシートを作成する

Wordドキュメントを作成する

PDFを生成する

次のステップ

前提条件

Agent Skillsの概要

ステップ1：利用可能なSkillsを一覧表示する

ステップ2：プレゼンテーションを作成する

ステップ3：作成されたファイルをダウンロードする

その他の例を試す

スプレッドシートを作成する

Wordドキュメントを作成する

PDFを生成する

次のステップ