# エージェントスキルとは

AIエージェントに業務の手順、参考資料、プログラムをフォルダ単位で付与し、該当する作業のときだけ読み込ませる仕組みです。同じ指示を毎回記述する手間を削減できる一方、内容の改訂と、外部から入手したスキルの審査が必要です。

## エージェントスキルとは

エージェントスキルは、AIエージェントが特定の作業に使用する手順、参考資料、プログラムを1つのフォルダに集約し、その作業のときだけ読み込ませる仕組みです。
フォルダには[SKILL.mdという名前のファイル](https://agentskills.io/specification)を必ず配置し、冒頭にスキルの名前と、何をするスキルでどの依頼のときに使用するかの説明を記述し、その後に手順を記述します。
同じフォルダに、手順の詳細を記述した文書、テンプレート、検証用のプログラムを追加できます。
目的は、同じ業務の手順を依頼のたびに記述せずに、誰が依頼しても同じ手順で作業させやすくすることです。

たとえば月次の売上報告を作成するスキルなら、集計の対象期間と除外する取引の条件、表の書式、前月との差が大幅な項目に理由を付記する規則をSKILL.mdに記述し、報告書のテンプレートと数値の検算用のプログラムを同じフォルダに配置します。
社員が月次の報告の作成を依頼すると、エージェントは説明から該当するスキルを判定し、手順を読み込んでから作業します。
Anthropicは、スキルの作成を[新任の担当者向けの業務の手引きの作成](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)に相当すると説明しています。

[公開の規格](https://agentskills.io/specification)に対応したエージェントは、起動時にすべてのスキルの名前と説明だけを読み込み、手順の本文は依頼が該当したときに、追加の資料は手順が参照したときに読み込みます。
読み込みを3段階に分割するため、多数のスキルを登録しても、使用しないスキルの手順で[コンテキストウィンドウが圧迫されにくい](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)構造です。
Claudeでは、同梱のプログラムを実行すると、コードそのものではなく[実行の結果だけ](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)がモデルに入力されます。

![起動時はスキルA、B、Cの説明を読み込み、依頼が該当したときはスキルBの手順だけを、手順が参照したときはスキルBの資料とプログラムの実行の結果だけを読み込むことを示す図](https://media.marketing.kdotdev-tunnel.org/glossary-agent-skills-1809409f984d2042e4a1544bcf929cd8c414edbe5d5f4331d4c4bdeb5ebadc9c.png)

プロンプトとの違いは、指示の範囲と保存の方法です。
プロンプトは1回の会話のための指示で、スキルは複数の会話と社員が反復して使用する手順をファイルとして保存し、該当する作業で自動的に読み込ませます。
MCP（Model Context Protocol）がAIを社内外のシステムに接続する規格であるのに対し、スキルは接続したツールをどの順序と条件で使用するかという手順をエージェントに付与します。

## 同じ指示を毎回記述する問題

スキルが登場する以前は、業務の手順をエージェントに遵守させるには、依頼のたびにプロンプトに手順を記述するか、すべての手順をプロジェクトの指示やカスタム指示のような常時読み込まれる設定に記述する必要がありました。
前者は社員ごとに指示の内容と精度が異なり、同じ業務でも結果が一定しません。
後者は業務の種類が増加するほど、どの作業にも無関係な手順が毎回入力に追加され、トークンの費用が増加し、作業に必要な指示が無関係な指示と混在して[精度が低下します](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents)。

Anthropicが公開した形式は[Agent Skillsという公開の規格](https://agentskills.io/home)になり、2026年11月時点では[ChatGPTとCodex](https://developers.openai.com/codex/skills)や[Cursor](https://cursor.com/docs/skills)なども同じ形式のスキルに対応しています。
1つの業務の手順を1つのフォルダとして作成すれば、通常のファイルと同じ方法で変更の履歴を管理でき、対応する複数のAI製品で利用できます。
ただし共通なのは基本の形式で、任意の項目の扱いや同梱のプログラムを実行できるかは製品ごとに異なるため、製品ごとに動作を確認します。

![業務Bを依頼したとき、常時読み込む設定では手順AからDまでのすべてが入力に含まれ、スキルでは手順Bだけが含まれることを示す図](https://media.marketing.kdotdev-tunnel.org/glossary-agent-skills-07d74888df7d6e99bda064b030159d348984fbdc6b0d1fca24bcf8dc8df98304.png)

## エージェントスキルの効果とコスト・リスク

### 効果

- 手順の統一。同じ業務を担当する社員の誰が依頼しても、同じ手順と書式で作業させやすくなる
- 指示の手間の削減。依頼のたびに手順や注意事項を記述する必要がない
- 入力の抑制。使用する作業でだけ手順を読み込むため、業務の種類が増加しても毎回の入力が増加しにくい
- 結果の固定。計算や形式の確認のように結果を一定にしたい工程を、モデルの生成ではなく同梱のプログラムに担当させられる

### コストとリスク

- 内容の保守。業務の規則や書式を変更したら、スキルの手順も改訂する。改訂しなければ、エージェントは旧版の手順のまま作業を継続する
- 作動の確認。エージェントは名前と説明でスキルを使用するかを判定するため、説明が曖昧だと該当する作業でもスキルを使用しないことがある。登録数が多いと、製品によっては[説明が短縮されるか一覧から除外される](https://developers.openai.com/codex/skills)。Anthropicは、代表的な作業でエージェントを稼働させ、不足する点を[観察してから作成する](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)よう推奨している
- 実行環境。プログラムを同梱するスキルには、コードを実行する環境が必要になる。その環境で許可するネットワークの接続先、認証情報の保管場所、実行の記録を管理する
- 外部のスキルの危険性。悪意のあるスキルは、手順の文章やプログラムでデータを外部に送信させ、意図しない操作をさせる[おそれがある](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)。Snykが公開の配布サイトのskills.shとClawHubで人気上位のスキル計2万件を分析した結果では、[65%を超えるスキルに何らかの問題](https://research.snyk.io/blog/skill-analysis/)があった。同じ分析で、2万件のうち[約1割が深刻度の高い問題](https://research.snyk.io/blog/skill-analysis/)と判定され、意図的に悪意のある手順と判定されたものには、APIキーを収集する手順も含まれた
- 管理の手間。部署ごとに別々にスキルを作成すると、同じ業務の重複したスキルや、担当者の異動で改訂が停止したスキルが発生する

![エージェントスキルの効果は手順の統一・指示の手間の削減・入力の抑制・結果の固定で、導入後には手順の改訂・作動の確認・実行環境の管理・外部のスキルの審査・重複と放置の整理が継続することを示す図](https://media.marketing.kdotdev-tunnel.org/glossary-agent-skills-6b1237f69dd60db6c8da717b54471c620bc4fbd7cfb9c34ec3a30053b21b58f0.png)

## 手順をスキルにするか依頼のたびに指示するか

同じ手順を反復して使用する業務はスキルにし、1回限りの作業や依頼ごとに条件が大幅に異なる作業は、依頼のたびにプロンプトで指示します。
スキルの作成と改訂に要する工数を、反復の使用で削減できる指示の工数が上回るかが基準です。
目安として、同じ手順を月に数回以上使用する業務や、複数の社員が同じ書式で作業する業務はスキルにする効果が高くなります。

| 業務の性質 | 手段 |
|---|---|
| 1回限り、または依頼ごとに条件が異なる | 依頼のたびにプロンプトで指示する |
| 同じ手順と書式を反復する | スキルにする |
| どの作業でも遵守させる規則 | プロジェクトの指示など常時読み込まれる設定に記述する |
| 社内のシステムやデータを参照・操作する | ツールやMCPで接続し、使用の手順をスキルに記述する |
| 計算や数値の検算のように結果を一定にしたい工程 | スキルに同梱するプログラムに担当させる |

どの作業でも遵守させる規則とは、顧客の個人情報を出力に記載しない、社外に送信する前に確認を求めるといった規則です。
スキルは該当する作業でだけ読み込まれるため、このような規則をスキルにだけ記述すると、別の作業では遵守されません。

![同じ手順を反復しない作業はスキルにせず依頼ごとにプロンプトで指示し、どの作業でも遵守させる規則はスキルにせず常時読み込む設定に記述し、それ以外の反復する手順をスキルにする判断の図](https://media.marketing.kdotdev-tunnel.org/glossary-agent-skills-5610b30897a11f5a3723c5288502189fb258e922ce18c6de01ad0eff8013df8a.png)

### スキルの作成の担当と手間

手順と資料だけのスキルは、業務の手順書を記述できる担当者が作成できます。
製品によっては、対話しながらフォルダの構成とSKILL.mdを生成する[作成支援の機能](https://claude.com/resources/articles/skills)があります。
作成したスキルは、製品の設定画面から登録するか、管理者が組織に配布するか、開発の作業ではリポジトリに配置して利用します。
目安として、手順だけのスキルは最初の版を数時間から数日で作成できます。
計算や検証のプログラムを同梱する場合は、プログラムの作成と、実行環境で稼働するかの確認を技術者が担当します。

作成後は、代表的な依頼を5〜10件程度用意し、スキルが使用されるか、期待どおりの手順と書式になるかを確認します。
同じ依頼は改訂のたびに再確認に使用します。

### スキルを導入する前に確認すること

| 確認すること | 満たしたい状態 |
|---|---|
| 提供元 | 社内で作成したか、利用する製品の提供元や接続先のサービスの提供元が公開したもの |
| 同梱のファイル | 手順の文章とプログラムを導入の前に通読し、外部への接続や認証情報の取り扱いがない |
| 配布の方法 | 管理者が組織で利用してよいスキルを指定できる |
| 担当者 | スキルごとに改訂の担当者が決定している |
| 確認の方法 | 代表的な依頼で、スキルが使用されて期待どおりの結果になることを改訂のたびに確認できる |

組織向けの製品の中には、管理者が承認したスキルを[組織の全員に配布できる](https://claude.com/blog/organization-skills-and-directory)ものがあります。
社員が個別に外部のスキルを導入できる設定のままにせず、配布の手段を管理者に限定するほうが安全です。

## よくある誤解

### スキルは手順を記述したファイルなのでシステムを操作させる危険はない

スキル自体は権限を保持しませんが、同梱のプログラムはエージェントの実行環境の権限で稼働します。
実行環境でネットワークや認証情報を利用できれば、プログラムがその範囲でシステムを操作できます。
システムの操作の可否は、スキルの有無ではなく、ツールやMCPの接続と実行環境の権限で制限します。

### スキルに記述した手順はエージェントが必ず遵守する

スキルを使用するかどうかはエージェントが説明から判定し、使用した場合も手順の記述は指示であって強制ではありません。
金額の上限や送信の禁止のように違反を容認できない条件は、スキルの文章ではなく、接続先のシステムの権限や人の承認で制限します。