Agent SkillsのAPI標準スキル一覧 — PDF・Excel・Word・PowerPoint生成

Claude APIには、自分でSkillを書かなくても最初から使える4つの標準Skillがあります。pptx・xlsx・docx・pdfです。PowerPointとWordは生成と編集、Excelは生成と分析、PDFは生成をそれぞれこなします。呼び出し方は4つとも共通で、containerパラメータにskill_idを1つ指定するだけです。

Agent SkillsのAPI標準スキルで何ができるか

標準Skillは、ドキュメント作成という特定領域の専門知識をClaudeに持たせるための既製部品です。プレゼン資料・集計用スプレッドシート・契約書のようなWord文書・請求書テンプレートのPDFまで、業務でよく使うファイル形式を一通りカバーします。

いずれもコード実行ツールの上で動きます。Claudeがコンテナ内でPythonライブラリを使ってファイルを組み立て、できあがったファイルをFiles APIへ送り、応答にはfile_idだけが返る仕組みです。ここでは呼び出し方と4つのSkillの違いを扱います。生成したファイルを取り出す手順はSkillsの生成ファイルをダウンロードする4ステップにまとめています。

使う前に必要なもの

APIキーと、コード実行ツールを有効にしたリクエストの2つだけです。コード実行ツールが対応していないモデルではSkillも使えないので、事前にツールのモデル互換性を確認しておきます。SDKを使う場合は各言語のクライアントライブラリ、curlで試す場合はjqがあると応答の整形に便利です。

一覧を取得して確認する

まず、どのSkillが使えるかをSkills APIで確認します。source=anthropicを付けると、Anthropicが提供する標準Skillだけに絞り込めます。

curl --fail-with-body -sS "https://api.anthropic.com/v1/skills?source=anthropic" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

返ってくるのはpptx・xlsx・docx・pdfの4件と、それぞれの名前・説明です。この一覧取得はSkillの中身(実行コードや詳細な指示)までは読み込みません。Claudeがまず名前と説明だけを見て「このSkillを使うべきか」を判断し、実際に使うと決めたときだけ詳しい指示を読み込む、という段階的な設計になっています。

この段階的な読み込みは3層に分かれています。1層目が常に読み込まれる名前と説明、2層目がSkillを使うと決めたときに読み込まれる詳しい指示、3層目が指示の実行中に必要な分だけ読み込まれるコードや参照ファイルです。標準Skillも同じ3層構造の上に成り立っており、リクエストのたびに全ての指示や参照ファイルをまとめて文脈に流し込むわけではありません。

PowerPointを生成する — 呼び出しの共通パターン

container.skillsにtype: "anthropic"とskill_idを指定し、toolsにコード実行ツールを含めます。この形はxlsx・docx・pdfでも共通で、skill_idの値だけが変わります。

curl --fail-with-body -sS https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 16000,
    "container": {
      "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    "messages": [
      {"role": "user", "content": "再生可能エネルギーについて5枚のスライドを作って"}
    ],
    "tools": [{"type": "code_execution_20260521", "name": "code_execution"}]
  }'

versionには日付形式(20251013のような値)かlatestを指定します。latestは常に最新版を使う代わりに、Anthropic側の更新でスライドの見た目や挙動が変わる余地があります。バージョンを固定した本番運用では日付形式を指定するのが安全です。

containerとtoolsの組み方からレスポンスに含まれるfile_idを取り出してFiles APIから実ファイルを取得するところまでの3ステップはAgent Skills APIクイックスタートで手順化しています。クイックスタート側は最短手順、本記事は4つの標準Skillの一覧と利用形態ごとの可否を扱います。

Excel・Word・PDFの呼び出し

3つともskill_idを差し替えるだけで、リクエストの骨格は同じです。

対応範囲はSkillごとに異なります。pptxとdocxは「ゼロから新規作成する」だけでなく既存ファイルを読み込んで一部を書き換える編集にも対応し、xlsxは新規作成と既存データの分析が中心、pdfは形式の性質上、生成した後の再編集より新規生成での利用が中心になります。

Excel(xlsx) — 表計算とグラフ付きレポートの生成。

{
  "container": {
    "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
  }
}

Word(docx) — 文書の作成・編集・書式設定。

{
  "container": {
    "skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
  }
}

PDF(pdf) — 請求書やレポートなど、体裁の整ったPDFの生成。

{
  "container": {
    "skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
  }
}

1リクエストで複数のSkillを同時に指定することもできます。上限は20個です。Excelのデータを読んでからPowerPointにまとめる、といった複合タスクではxlsxとpptxを同じcontainer.skills配列に並べます。

標準Skillとカスタムスキルの違い

標準Skillだけでなく、自分で作ったカスタムSkillも同じcontainerパラメータで呼び出せます。統合の形は同一ですが、識別子の付き方と管理方法が違います。

カスタムSkillはSkills APIの/v1/skillsエンドポイント群(作成・一覧・取得・削除)で自分でアップロード・管理します。一覧取得ではsourceパラメータをanthropicとcustomのどちらにも切り替えられ、両方の種類が同じskills/listエンドポイントから返ってきます。統合の仕組みが共通なので、標準Skillからカスタムへ切り替えるときにコードの構造を変える必要はありません。

データの扱いとネットワーク制限

Agent SkillsはZDR(ゼロデータ保持)の対象外です。Skillの定義自体と実行時のデータは、Anthropicの標準的なデータ保持ポリシーに従って保持されます。ZDR契約を前提に設計しているワークスペースは、この点を先に確認しておく必要があります。

ネットワークアクセスの扱いも面によって違います。API上のSkillはネットワークアクセスを一切持ちません。一方claude.aiでは、ユーザーや管理者の設定次第でSkillが「フル・部分的・なし」のいずれかのネットワークアクセスを持つことがあります。同じ「Skill」という言葉でも、動く環境によって前提が変わる点には注意が必要です。

組織でCompliance APIを有効にしている場合、Activity FeedにカスタムSkillとそのバージョンの作成・削除が記録されます。APIキーやClaude Console経由の操作が対象で、Compliance APIをオフにしていた期間の操作は記録されず後から復元もできません。監査証跡を前提に運用するなら、Skillの利用を始める前にCompliance APIを有効化しておく必要があります。

どの面で使えるか、面ごとに違う

同じ「Agent Skills」という名前でも、標準Skillが使えるかどうかは利用形態によって変わります。API実装者はここを取り違えると、動くはずのコードが別の面では動かなくなります。

Claude Platform on AWSとMicrosoft Foundryは、この表のAPI行と同じ挙動です。ただしMicrosoft Foundryでは「Hosted on Anthropic」構成を選んでいる場合に限られ、それ以外のホスティング構成では標準Skillは使えません。カスタムSkill(自分でアップロードするSkill)は逆にこの3つの面それぞれで個別管理が必要で、API・claude.ai・Claude Codeの間で自動同期はされません。ある面にアップロードしたカスタムSkillを別の面でも使いたい場合は、面ごとに個別にアップロードし直します。

よくあるつまずき

コード実行ツールを付け忘れるケースが最も多いつまずきです。Skillはコード実行ツールの上で動くので、tools配列にcode_executionを含めないとSkillが機能しません。エラーメッセージが分かりにくいことがあるので、まずtoolsの指定を疑います。

API上のSkillはサンドボックス化されたコンテナで動き、ネットワークアクセスも実行時のパッケージインストールもできません。Skillに外部APIを呼ばせたいという要求は、API面では原則実現できないと割り切ります。

claude.aiにアップロードしたカスタムSkillはAPIには現れません。逆も同様です。「1回アップロードすれば全面で使える」という思い込みは崩れます。チームで同じSkillを複数面で使いたいなら、面ごとにアップロード作業が必要です。

カスタムSkillをアップロードする場合、全ファイル合計で30MB(非圧縮)という上限があります。画像やサンプルデータを多く同梱するSkillでは事前にサイズを確認しておきます。

container.skillsの配列は1リクエストあたり20個までです。汎用的に使えそうなSkillを片っ端から並べる設計にすると、この上限にすぐ当たります。実際にそのリクエストで使う可能性があるSkillだけに絞り込むのが安全です。

まとめ

Agent SkillsのAPI標準スキルは、PowerPoint・Excel・Word・PDFという頻出のドキュメント形式を、container.skillsにskill_idを指定するだけで生成できる既製部品です。前提はAPIキーとコード実行ツールの2つ。呼び出しの形は4つとも共通で、違いはskill_idの値だけです。

使える面はClaude APIとclaude.aiに限られ、Claude Codeには含まれません。この面ごとの違いを踏まえたうえで、生成したファイルの実体をどう取り出すかはSkillsの生成ファイルをダウンロードする4ステップで扱っています。Agent Skillsの設計思想そのものを知りたい場合はAgent Skillsとは何かを、コード実行ツールの課金条件はコード実行ツールが無料になる条件を、code_execution_20260521のようなツールのバージョン表記の読み方はClaude APIツールのバージョン管理の読み方と使い分けを参照してください。