Skills
Skills は、専門的なタスクでのパフォーマンスを向上させるために Claude が動的に読み込む、指示・スクリプト・リソースのフォルダです。
あらゆる Skill の中核にあるのは SKILL.md ファイルです。これは、一度アップロードすれば、あらゆる messages.create 呼び出しにアタッチできる、パッケージ化された指示のセットです。
あなたは Claude に、あなたがどのように物事を行うかを教えています。たとえば、あなたのステータスレポートの形式、あなたのレビューチェックリスト、あなたのリリースノートなどです。
Claude は Skill を読み、その手順に従い、あなたの形式に沿った出力を生成します。
Skills とツールの違い
2つは異なる問題を解決するものなので、その違いを明確にしておく価値があります。
- ツール は Claude をデータやアクションに接続します。「このコードセクションを調べて」「このメールを送信して」——Claude がツールを呼び出し、何か他のものが実行されます。
- Skills は Claude に手順を教えます。「このテンプレートに従って日次ステータスレポートを生成して」——これは Claude が読んで従う手順書であり、時にはバンドルされたスクリプトを自ら実行することを意味します。
覚えておくシンプルな方法: ツールは Claude が何をできるかについてのものであり、Skills はそれをどのように実行してほしいかについてのものです。

もう一つ知っておく価値があるのは、Skills は起動時にコンテキストへ完全には読み込まれないということです。最初に読み込まれるのは名前と説明だけです。エージェントが Skill が関連していると判断すると、その時点で Skill の全体がコンテキストに読み込まれます。これにより、多数の Skill が利用可能な場合でも、コンテキストを軽量に保つことができます。
Skill のアップロード
Skills はワークスペースに一度アップロードされ、その後 ID で参照されます。Claude Platform 上で直接アップロードすることも、プログラムで行うこともできます。
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 を指定します。ステータスレポート生成ツールの完全な呼び出しは以下の通りです。
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 の中にあります。

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

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