「同じ手順をAIに説明するのは、これで何回目だろう」と感じる場面は、エージェントを使い込むほど増えてきます。
レポートの書式、社内ツールの叩き方、レビューで見るポイント。
毎回プロンプトに貼るのは手間ですし、全部を常に読ませるとコンテキストがどんどん膨らんでいく。
その間を埋める仕組みとして Anthropic が用意したのが、Agent Skills（エージェントスキル）です。
手順書を増やすほどAIが重くなるのでは、と気になったことはありませんか？
Agent Skillsは「フォルダに入った手順書」
Agent Skills は、指示・メタデータ・スクリプトなどをひとまとめにして、Claude に専門的な作業を任せるための仕組みです。
公式ドキュメントでは、汎用のエージェントを特定の仕事の担い手に変える、ファイルベースの再利用できる資源として説明されています。
Agent Skills（Claude Platform Docs）
プロンプトとの違いは、読み込まれるタイミングにあります。
プロンプトは会話ごとに渡す一回きりの指示ですが、Skills は関係する依頼が来たときだけ自動で読み込まれるので、同じ説明を毎回くり返さずに済む。
実体はとても素朴で、SKILL.md というファイルを入れたフォルダが 1 つのスキルになります。
公式ドキュメントに載っている PDF 処理スキルの例が、次の構成。
pdf-processing/
├── SKILL.md （手順の本体）
├── FORMS.md （フォーム入力の手引き）
├── REFERENCE.md （詳しいリファレンス）
└── scripts/
└── fill_form.py先頭には「名前」と「いつ使うか」を書く
SKILL.md の冒頭には、YAML 形式のフロントマターで name と description を置きます。
name は小文字の英数字とハイフンだけで最大 64 文字、description は空にできず最大 1024 文字という決まりです。
大事なのは description のほうで、Claude はこの説明文と依頼内容を突き合わせて、スキルを使うかどうかを判断します。
そのため、「何をするか」と「いつ使うか」の両方を書いておく必要があるのです。
イメージとしては、次のような書き方。
---
name: weekly-report
description: 週報の下書きを作る。ユーザーが「週報」や「今週のまとめ」に触れたときに使う。
---
（ここから下に、実際の手順や注意点を書く）必要な分だけ読む「段階的な開示」
Skills の設計でいちばん効いているのが、段階的な開示（progressive disclosure）という考え方です。
中身を一度に読ませるのではなく、3 つの段階に分けて、必要になった分だけコンテキストに入れていきます。
- レベル1（メタデータ）：起動時に必ず読み込まれる。name と description だけで、1 スキルあたり約 100 トークン
- レベル2（SKILL.md の本文）：スキルを使うと判断されたときに読み込まれる。目安は 5,000 トークン未満
- レベル3（追加のファイルやスクリプト）：必要になったときだけ読まれ、アクセスされるまで消費はゼロ
つまり、使っていないスキルは、名前と説明文のぶんしか場所を取らないわけです。
ただし、レベル1 はスキルの数だけ積み上がり、入れたまま使わないスキルの説明文も起動のたびに読み込まれます。
この説明文が入る先はシステムプロンプトで、その役割は別の記事で整理しました。
スクリプトは「中身」ではなく「結果」だけが入る
レベル3 に置いたスクリプトの扱いも、この設計の要になっています。
Claude はスクリプトを bash で実行し、コンテキストに入るのは実行結果だけで、コードそのものは読み込まれません。
同じ処理を毎回 AI にコードとして書かせるより、決まった処理はスクリプトに任せたほうが、トークンの節約にも結果の安定にもつながる。
手順は文章で、決まりきった処理はコードで持たせるという分担が、Skills のいちばんの使いどころ。
使える場所と、入れる前の注意
Agent Skills は Claude の各製品で使えますが、置き場所と共有のされ方はそれぞれ異なります。
- Claude Code：
~/.claude/skills/（個人用）か.claude/skills/（プロジェクト用）にフォルダを置いて使う - Claude API：PowerPoint・Excel・Word・PDF の既製スキルと、Skills API でアップロードした独自スキルを使える（コード実行ツールが前提）
- claude.ai：既製スキルは文書の作成時に使われ、独自スキルは設定画面から zip でアップロードする
注意したいのは、独自スキルは製品間で自動的には同期されないという点です。
claude.ai に入れたスキルは API からは使えず、Claude Code のスキルはどちらとも別の管理になります。
形式そのものは Claude に閉じたものではなく、2025年12月にはオープンな標準として仕様が公開されました。
Agent Skills の仕様（GitHub）
もう一つ気をつけたいのが安全性です。
スキルは指示とコードでエージェントに能力を足すものなので、悪意のあるスキルを入れると、見かけの目的と違うツール操作やデータの持ち出しにつながるおそれがあります。
公式ドキュメントも、入手元を自作や Anthropic 提供のものなど信頼できる範囲に限り、そうでないものは同梱ファイルまで監査してから使うよう求めているのです。
スキルを入れることは、ソフトウェアを入れることと同じと考えておくと判断を誤りません。
最後に
Agent Skills は、手順書をフォルダに入れて、必要なときだけ読ませる仕組みです。
プロジェクト全体の前提を書いておく AGENTS.md に対して、Skills は特定の作業の手順を出番が来たときだけ呼び出せる置き場と整理できます。
モデルの外側でこうした読み込みや道具の出し入れを受け持つ部分は「ハーネス」と呼ばれ、同じモデルでもここ次第で使い勝手とコストが変わる。
まずは、よく説明し直している手順を 1 つだけスキルにしてみると、効き目が見えやすいはず。
以上です。
コメントを残す