メインコンテンツへスキップ
このチュートリアルでは、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

サンプルSkillsと実装パターンを探索