AIのスキルを追加すると全文を毎回読む？説明・指示・追加資料の読込

情報確認日：2026年10月15日

Agent Skillsは、すべての資料を毎回まとめて読む仕組みではありません。まず名前と説明を参照し、仕事に必要なスキルが選ばれると指示本文を読み、追加資料やスクリプトは必要に応じて使います。フォルダーを置いたこと、選ばれたこと、実行されたことを分けて確認してください。

この記事は、公開されているAgent Skillsの形式を扱います。特定サービスの同名機能すべてが、同じ設定方法や権限を持つという説明ではありません。Agent Skillsの概要と仕様を基に整理します。

説明・指示・追加資料を、三段階に分けて読む

公式の概要は、スキルの読込みをDiscovery、Activation、Executionの三段階で説明しています。最初から関連ファイルの全文が、どの会話でも入るわけではありません。

説明に書かれた分野と今回の仕事が合わなければ、選ばれない場合があります。また、指示に資料のリンクがあっても、そこを読んだかは別です。資料の所在と参照した範囲を確認します。

仕様上、スキルは少なくともSKILL.mdを含むディレクトリーです。ファイルの先頭には、YAML形式の名前・説明等のメタデータを置き、その後にMarkdown形式の指示を書きます。

nameとdescriptionは必須です。descriptionは、「何をするか」だけでなく「いつ使うか」を説明します。「便利な作業をする」のような広い説明より、対象ファイルや目的が分かる説明が選択の手掛かりになります。

ただし、スキルをどこに配置するか、インストール方法、呼び出すコマンドは使う製品の案内で確認します。公開形式のフォルダー構造だけを見て、すべてのアプリが任意の場所から自動検出すると判断しないでください。

仕様では、指示本文を短く保ち、詳細を参照ファイルに分ける方法を勧めています。目安としてSKILL.mdを500行未満、指示本文を5,000トークン未満とする推奨があります。絶対に動かなくなる共通上限という意味ではありません。

たとえば記事制作なら、指示本文に「どんな成果を作るか」「どの資料をいつ読むか」を書き、媒体別の詳しい手順をreferences/へ分ける構成が考えられます。これは整理の例です。

参照先は、スキルのルートからの相対パスで示します。参照を何段もたどらないと重要条件へ着けない構成より、必要な資料を直接選べる構成にします。資料を分けた後は、指示本文からその存在が分かるかも確認します。

scripts/には実行用コード、references/には説明資料、assets/にはテンプレート等を置けます。これらは任意です。コードを含まない、指示と資料だけのスキルもあり得ます。

実行できる言語やツールはエージェント側の実装に依存します。必要なプログラム、ネット接続、実行権限がない環境では、同じフォルダーを置いても同じ処理ができるとは限りません。

allowed-toolsは仕様上、実験的な項目です。その記載があるだけで、製品の権限制限や利用者の承認がすべて解除されるものと扱いません。何を実行し、どこを書き換えるスキルかを、導入前に指示とコードから確認します。

導入後は、そのスキルが対象とする小さな仕事を一つ依頼します。名前が表示されたかだけでなく、指示本文が読まれ、必要な資料が参照され、期待した成果が作られたかを確認してください。

うまく選ばれなければ、まず対象アプリでスキルが認識されているか、名前とdescriptionが正しいかを見ます。選ばれたのに成果が違うなら、本文の指示、参照パス、資料の版、実行結果を調べます。全部をdescriptionへ詰め込む前に、どの段階で止まったかを分けます。

スクリプト実行を報告させる場合は、実行したファイル、入力、出力先、結果を残します。「手順に実行と書いてある」ことを実行記録の代わりにしないようにします。

指示を直したら、参照資料やテンプレートも古い前提のままでないかを見ます。逆に、詳細資料を差し替えた場合は、本文がその版へ案内しているかを確認します。

スキルは繰り返す仕事の手順をまとめる道具です。追加しただけで毎回正確に動く保証ではないため、実際に選ばれた範囲と、確認できた成果を記録します。使う製品を変えるときも、公開形式への対応と、その環境の権限・ツールをあらためて確かめてください。

執筆・検証：カネさん（政経プラスチャンネル運営）＋ ChatGPT

ほかの記事を探す