エージェントスキル

APIでAgent Skillsを始める

10分以内にClaude APIでAgent Skillsを使用してドキュメントを作成する方法を学びます。

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

前提条件

Anthropic 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をリストアップします：

import anthropic

client = anthropic.Anthropic()

# Anthropicが管理するSkillsをリストアップ
skills = client.beta.skills.list(
    source="anthropic",
    betas=["skills-2025-10-02"]
)

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

以下のSkillsが表示されます：pptx、xlsx、docx、およびpdf。

このAPIは各Skillのメタデータ（名前と説明）を返します。Claudeはこのメタデータをスタートアップ時に読み込んで、利用可能なSkillsを知ります。これは段階的な情報開示の最初のレベルであり、Claudeは完全な指示をまだ読み込まずにSkillsを発見します。

ステップ2: プレゼンテーションを作成

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

import anthropic

client = anthropic.Anthropic()

# PowerPoint Skillでメッセージを作成
response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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(response.content)

各部分が何をするかを分解してみましょう：

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

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

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

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

# レスポンスからファイルIDを抽出
file_id = None
for block in response.content:
    if block.type == 'tool_use' and block.name == 'code_execution':
        # ファイルIDはツール結果に含まれている
        for result_block in block.content:
            if hasattr(result_block, 'file_id'):
                file_id = result_block.file_id
                break

if file_id:
    # ファイルをダウンロード
    file_content = client.beta.files.download(
        file_id=file_id,
        betas=["files-api-2025-04-14"]
    )

    # ディスクに保存
    with open("renewable_energy.pptx", "wb") as f:
        file_content.write_to_file(f.name)

    print(f"Presentation saved to renewable_energy.pptx")

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

さらに多くの例を試す

Skillsで最初のドキュメントを作成したので、これらのバリエーションを試してください：

スプレッドシートを作成

response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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"
    }]
)

Wordドキュメントを作成

response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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"
    }]
)

PDFを生成

response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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を使用したので、以下のことができます：

APIガイド

Claude APIでSkillsを使用

カスタムSkillsを作成

専門的なタスク用に独自のSkillsをアップロード

オーサリングガイド

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

Claude CodeでSkillsを使用

Claude CodeでのSkillsについて学ぶ

Agent SDKでSkillsを使用

TypeScriptとPythonでSkillsをプログラムで使用

Agent Skills Cookbook

エージェントスキル

APIでAgent Skillsを始める

10分以内にClaude APIでAgent Skillsを使用してドキュメントを作成する方法を学びます。

前提条件

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

Agent Skillsとは何ですか？

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

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

ステップ1: 利用可能なSkillsをリストアップ

まず、利用可能なSkillsを確認しましょう。Skills APIを使用してすべてのAnthropicが管理するSkillsをリストアップします：

import anthropic

client = anthropic.Anthropic()

# Anthropicが管理するSkillsをリストアップ
skills = client.beta.skills.list(
    source="anthropic",
    betas=["skills-2025-10-02"]
)

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

以下のSkillsが表示されます：pptx、xlsx、docx、およびpdf。

ステップ2: プレゼンテーションを作成

import anthropic

client = anthropic.Anthropic()

# PowerPoint Skillでメッセージを作成
response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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(response.content)

各部分が何をするかを分解してみましょう：

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

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

# レスポンスからファイルIDを抽出
file_id = None
for block in response.content:
    if block.type == 'tool_use' and block.name == 'code_execution':
        # ファイルIDはツール結果に含まれている
        for result_block in block.content:
            if hasattr(result_block, 'file_id'):
                file_id = result_block.file_id
                break

if file_id:
    # ファイルをダウンロード
    file_content = client.beta.files.download(
        file_id=file_id,
        betas=["files-api-2025-04-14"]
    )

    # ディスクに保存
    with open("renewable_energy.pptx", "wb") as f:
        file_content.write_to_file(f.name)

    print(f"Presentation saved to renewable_energy.pptx")

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

さらに多くの例を試す

Skillsで最初のドキュメントを作成したので、これらのバリエーションを試してください：

スプレッドシートを作成

response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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"
    }]
)

Wordドキュメントを作成

response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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"
    }]
)

PDFを生成

response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    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を使用したので、以下のことができます：

APIガイド

Claude APIでSkillsを使用

カスタムSkillsを作成

専門的なタスク用に独自のSkillsをアップロード

オーサリングガイド

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

Claude CodeでSkillsを使用

Claude CodeでのSkillsについて学ぶ

Agent SDKでSkillsを使用

TypeScriptとPythonでSkillsをプログラムで使用

Agent Skills Cookbook