AIエージェントを使っていると、同じ説明を何度も書く場面が出てきます。レビューの観点、公開前の確認項目、調査の順序。会話の中だけに置くと、次の仕事では消えてしまいます。
Agent Skillsは、その手順をフォルダーとして残す仕組みです。中心にあるのはSKILL.md。必要なら参考資料やスクリプト、テンプレートを隣に置けます。
長いプロンプトではない
Skillは知識を詰め込む箱ではありません。ひとつの仕事をどう始め、どこを確認し、何を返すかを記した手順書です。担当者が変わっても工程をたどれる。その状態をエージェントにも作ります。
エージェントは最初から全Skillの本文を読みません。まず名前と説明を見ます。依頼に合うSkillだけを選び、その時点で詳しい指示を読み込みます。必要な情報を必要なときだけ開く仕組みです。
どんな仕事に使うかを示す小さな索引
手順、判断基準、完了条件
詳しい資料、処理、ひな型
ひとつのSkillに入るもの
必須なのはSKILL.mdだけです。ほかのフォルダーは、仕事に必要なときだけ加えます。最初から全部を用意する必要はありません。
SKILL.md目的、呼び出す条件、手順、出力必須references/方針、仕様、長い参考資料必要ならscripts/同じ結果が必要な計算や処理必要ならassets/ひな型や成果物に使う素材必要ならagents/openai.yaml表示情報や必要なツール任意最小のSkillは、これだけでも成立します。
---
name: product-copy-review
description: Review product copy before publication. Use for English,
Japanese, or French web copy; do not use for legal review.
---
1. Read the page in its full context.
2. Flag unclear claims and repeated wording.
3. Preserve technical meaning while revising.
4. Return the revised copy with a short reason for each material change.descriptionは紹介文ではなく、呼び出し条件です。何に使い、何には使わないかを先に書くと、違う仕事へ割り込むのを防げます。
似ている仕組みとの違い
迷ったときは、情報の寿命と役割で分けると整理できます。
| 仕組み | 向いていること | 性格 |
|---|---|---|
| プロンプト | 今この場の依頼 | 一回の仕事に合わせる |
AGENTS.mdなど | リポジトリの常設ルール | その場所で継続して効く |
| Skill | 繰り返し使う作業手順 | 必要な仕事で呼び出す |
| MCPサーバー | 外部データ、認証、操作 | 情報や道具を提供する |
| プラグイン | Skillや接続先の配布 | 複数の機能をまとめる |
MCPがデータと操作を受け持つなら、Skillはその使い方を受け持ちます。「顧客情報を取得する」は道具の仕事。「取得した情報から面談メモを作る順序」はSkillの仕事です。
よいSkillは小さい
大きなSkillは便利に見えますが、呼び出す条件も成功の基準も曖昧になります。入力、手順、出力がひと続きになる範囲に絞る方が扱いやすくなります。
何を受け取るか
何を確かめるか
何を返せば終わりか
- 何を受け取るかを書く。
- どこまで進めたら完了かを書く。
- 推測してはいけない事実を決める。
- 質問する場面と止まる場面を決める。
- 参考資料を読む条件を明示する。
完成したら、正しい依頼だけで試して終わりにしません。直接の依頼、遠回しな依頼、情報が足りない依頼、呼び出すべきでない依頼、失敗しやすい境界例。この5種類を通すと、descriptionと本文のどちらに問題があるか見えてきます。
共有形式と実際の配置
Agent Skillsには公開仕様があります。ただし、見つける場所や呼び出し方まで全エージェントで同じとは限りません。共通なのはSkillの考え方と基本構造です。実際の配置は使う製品の仕様を確認します。
Codexは、作業中の場所からリポジトリのルートまでにある.agents/skillsを探します。個人用のSkillは$HOME/.agents/skills、管理者が用意するSkillは/etc/codex/skillsに置けます。配布まで考えるなら、Skillをプラグインにまとめる方法もあります。
同じ名前のフォルダーを置けば、どのエージェントでも同じように動くとは限りません。対応形式、探索場所、補助メタデータの差は残ります。
Skillは権限ではない
Skillは手順書です。ネットワークやファイルへの権限を増やすものではありません。認証が必要な操作は接続先の仕組みに従い、危険な操作はエージェント側の承認やサンドボックスに従います。
scripts/に入ったファイルは実際のコードです。入手元が分からないSkillは、本文だけでなくスクリプトと依存先も確認してから使うべきです。
手順を見える形にする
Skillの価値は、AIを万能に見せることではありません。仕事の進め方がファイルとして残ることにあります。人が読める。直せる。差分を確かめられる。判断を渡し切らずに、繰り返す部分だけを道具にできます。
曖昧な指示を魔法のまま扱わない。それが、Agent Skillsを使ういちばん実務的な理由です。
参考資料
製品ごとの対応状況は変わることがあります。本記事は2026年8月7日時点の公開仕様を確認して作成しました。