読み込み中
読み込み中

Skills

Skills は、専門的なタスクでのパフォーマンスを向上させるために Claude が動的に読み込む、指示・スクリプト・リソースのフォルダです。 あらゆる Skill の中核にあるのは SKILL.md ファイルです。これは、一度アップロードすれば、あらゆる messages.create 呼び出しにアタッチできる、パッケージ化された指示のセットです。 あなたは Claude に、あなたがどのように物事を行うかを教えています。たとえば、あなたのステータスレポートの形式、あなたのレビューチェックリスト、あなたのリリースノートなどです。 Claude は Skill を読み、その手順に従い、あなたの形式に沿った出力を生成します。

Skills とツールの違い

2つは異なる問題を解決するものなので、その違いを明確にしておく価値があります。

  • ツール は Claude をデータやアクションに接続します。「このコードセクションを調べて」「このメールを送信して」——Claude がツールを呼び出し、何か他のものが実行されます。
  • Skills は Claude に手順を教えます。「このテンプレートに従って日次ステータスレポートを生成して」——これは Claude が読んで従う手順書であり、時にはバンドルされたスクリプトを自ら実行することを意味します。

覚えておくシンプルな方法: ツールは Claude が何をできるかについてのものであり、Skills はそれをどのように実行してほしいかについてのものです。

ツールと Skills の比較: ツールはデータに接続し、アクションを実行し、コードを実行する——Claude が何をできるか; Skills は指示だけで手順を教え、コードは実行されない——どのように実行してほしいか

もう一つ知っておく価値があるのは、Skills は起動時にコンテキストへ完全には読み込まれないということです。最初に読み込まれるのは名前と説明だけです。エージェントが Skill が関連していると判断すると、その時点で Skill の全体がコンテキストに読み込まれます。これにより、多数の Skill が利用可能な場合でも、コンテキストを軽量に保つことができます。

Skill のアップロード

Skills はワークスペースに一度アップロードされ、その後 ID で参照されます。Claude Platform 上で直接アップロードすることも、プログラムで行うこともできます。

python
import anthropic
from anthropic.lib import files_from_dir

client = anthropic.Anthropic()

skill = client.skills.create(
    display_name="Status Report Generator",
    files=files_from_dir("status-report-skill"),  # folder containing SKILL.md
)

print(skill.id)  # reference this ID in future requests

この例では、ステータスレポート生成ツールを用意したいと思います。優れたステータスレポートを構成する要素——セクション、トーン、要約の仕方、ブロッカーの扱い方など——はすべて、事前にパッケージ化された Skill の中にあります。アクティビティログ自体は、リクエスト時に渡されるただの文字列にすぎません。

リクエストへの Skill のアタッチ

Skills は、コンテナ設定を通じてリクエストにアタッチされます。コンテナ内に skills 配列があり、各エントリが skill_id と version を指定します。ステータスレポート生成ツールの完全な呼び出しは以下の通りです。

python
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": skill.id,
                "version": "latest",
            }
        ]
    },
    tools=[
        {
            "type": "code_execution_20250825",
            "name": "code_execution",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
        }
    ],
)

いくつか指摘しておきたい点があります。

  • ここでは、ベータヘッダーなしで標準の client.messages.create を呼び出しています。Skills は Claude API で一般提供されているため、skills-2025-10-02 ベータヘッダー はもはや不要です。引き続きそれを送信するリクエストも、変更なく動作し続けます。
  • container.skills が Skill をアタッチする場所です。これはリストなので、1回の呼び出しに複数の Skills を重ねることができます。
  • コード実行 もここで有効になっています。これは必須です。API 上では、Skills はコード実行ツールのコンテナ内で実行され、これにより Skill の手順——ターミナルでスクリプトを実行するなど——が実際の作業を行えるようになります。

実行してみる

出力は、Skill が指定する形式通りに整形されたステータスレポートです。セクション、トーン、ブロッカーの扱い——そのすべてが、あなたがアップロードした SKILL.md ファイルから来ています。ユーザープロンプトは一行だけで、手順は Skill の中にあります。

生成された日次ステータスレポートのターミナル出力。完了済みとブロッカーのセクション、そして Skill によって整形された要約がある

実運用のアプリでは、これがチームが機能全体にわたって出力を標準化する方法です。この日次ステータスレポートのエンドポイントにより、すべての PM が同じ構造、同じトーン、同じセクションを、同じ順序で得られます——誰もプロンプトにテンプレートをコピーペーストすることなく。

プロジェクト管理アプリの日次レポートページ。各プロジェクトのアクティビティログには、Skill を裏側で使ったワンクリックの「レポート生成」ボタンがある

まとめ

  • Skills はあなたの手順をパッケージ化します。 SKILL.md ファイル(および任意のスクリプトやリソース)が、物事をどのように行ってほしいかを Claude に教えます。
  • ツール対 Skills: ツールは Claude が何をできるかについてのものであり、Skills はそれをどのように実行してほしいかについてのものです。
  • Skills は段階的に読み込まれます。 起動時には名前と説明だけが読み込まれ、エージェントが使用することを決めた時点で Skill 全体がコンテキストに読み込まれます。
  • client.skills.create で一度アップロードし、あらゆる messages.create 呼び出しで container.skills を使ってアタッチします——これはリストなので、複数の Skills を重ねることができます。
  • Skill の手順が実際の作業を必要とする場合は、コード実行と組み合わせます。
  • どのようにが何をと同じくらい重要な場合は、Skill の利用を検討してください。