ブログに戻る

AI入門ガイド

エージェントスキル(SKILL.md)とは何か、そして精査する方法

スキルとは、必要なときにだけエージェントが読み込むSKILL.mdファイルを含むフォルダです。プロンプトとの違い、トークンコスト、精査の方法を説明します。

投稿者: CheapTokens Team公開日 読了時間 9 分

名前と説明フィールドを持つSKILL.mdファイルのヘッダー
このページの内容
  1. スキルとは何か、プロンプトとの違い
  2. スキルがコンテキストウィンドウに入る仕組み
  3. 2分で最小のスキルを書く
  4. スキル、AGENTS.md、MCP: それぞれ何が違うか
  5. インストール前に第三者のスキルを精査する

スキルとは、コーディングエージェントが探す場所に置かれた SKILL.md ファイルを含むフォルダです。エージェントはあなたのリクエストがそれに一致したときだけそのファイルを読みます。それまではスキルのコストは約100トークンですが、プロンプトは貼り付けたすべてのメッセージに付いて回ります。

READMEでこの言葉を見たことがあるでしょう。「スキルをインストールして、エージェントに…と頼んでください」。不思議なことは何も起きていません。以下では、中身は何か、いつコンテキストウィンドウに入るのか、そして自分のマシンに入れる前にどう確認するかを説明します。

スキルとは何か、プロンプトとの違い#

AnthropicのAgent Skillsドキュメント(2026年10月30日確認)では、スキルを再利用可能なファイルシステムベースのリソースとして説明しています。すなわち、SKILL.md ファイルを含むディレクトリに、任意のスクリプト、テンプレート、参照ファイルが加わったものです。SKILL.md は小さなYAMLヘッダー(名前と説明)で始まり、その後に平文の指示が続きます。

新しい同僚を思い浮かべてください。プロンプトは、あなたがその人の椅子の後ろに立って毎朝ルールを繰り返すことです。スキルは棚に置かれたバインダーで、背表紙にラベルがあります。「コミットメッセージのスタイル。誰かがコミットを頼んだら読むこと」。必要になったときだけ取り下ろされます。

フラッシュカード

どのスキルのREADMEでも出会う言葉

ヘッダーのフィールドは2つが必須で、形式にはルールがあります。ClaudeのSkills形式では、name は最大64文字で、小文字、数字、ハイフンを使い、「anthropic」や「claude」という語を含められません。description は空にできず、上限は1,024文字で、スキルが何をするかと、いつ使うかの両方を述べる必要があります。

スキルのフォルダ: SKILL.mdと任意のテンプレート、スクリプト
スキルの形: 必須ファイルは1つ、それ以外はすべて任意。

スキルがコンテキストウィンドウに入る仕組み#

ドキュメントではこれを段階的開示と呼んでいます。エージェントはスキルを3段階で読み、各段階のコストはそこに到達した場合にだけ支払われます。

  • レベル1、常に読み込まれる。 インストールされたすべてのスキルの名前と説明で、スキルあたり約100トークン。
  • レベル2、トリガーされたとき。 SKILL.md の本文で、5,000トークン未満。
  • レベル3、必要なときだけ。 同梱ファイルとスクリプト。エージェントがスクリプトを実行するとき、スクリプトのコードはコンテキストに入らず、出力だけが入ります。

トークン数はドキュメントによる概算であり、正確な数ではありません。

順番に並べる

3つの段階をエージェントが出会う順に並べる

  1. エージェントが起動し、インストールされたすべてのスキルの名前と説明を読む
  2. あなたのリクエストが1つの説明に一致し、SKILL.mdの本文が読まれる
  3. 指示がスクリプトやテンプレートに言及し、そのファイルが使われる
3つの読み込みレベル: 名前と説明、SKILL.mdの本文、同梱ファイル
各レベルは、前のレベルが必要と判断した場合にだけ読まれる。

これがあなたの請求にどう関係するかを説明します。20個のスキルをインストールしたとします。20 × 100 = 2,000トークンが最初のメッセージから付いて回ります。エージェントは各ステップでコンテキストを再送するので(20ステップの例がその理由を示しています)、50ステップのセッションでは50 × 2,000 = 100,000入力トークン分のスキルラベルを運ぶことになります。DeepSeek-V4-Flashでは、現在の価格で $0.0015 です。

逆の場合も見てみましょう。その20個のスキルを1つの大きなプロンプトとして貼り付けたなら、各本文が毎回のリクエストに含まれます。リクエストあたり最大20 × 5,000 = 100,000トークンで、セッションあたりではありません。この差がオンデマンド読み込みの要点です。「コンテキストウィンドウ」という用語がまだ曖昧なら、この解説が何で埋まるかを扱っています。

スキルはコンテキスト内に存在するので、エージェントの背後にあるモデルにはそれ用の余裕が必要です。CheapTokensのDeepSeek-V4-Flash(id deepseek-ai/DeepSeek-V4-Flash-0731)は380Kのコンテキストウィンドウと回答あたり最大32,768出力トークンを持ち、時間帯を問わず同一価格で、OpenAIおよびAnthropic互換のAPIを備えています。ターミナルエージェントについてはClaude CodeをCheapTokensに接続する方法に従ってください。その他のツールはドキュメントから始めてください。モデル自体のページはこちらです。

2分で最小のスキルを書く#

1つ書いた後のほうが読みやすくなります。このスキルはエージェントにコミットメッセージを固定形式で書かせます。Claude Codeでは、個人スキルは ~/.claude/skills/ に、プロジェクトスキルは .claude/skills/ に置かれるので、プロジェクトスキルはリポジトリと一緒に移動できます。

bash
mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

これをファイルに貼り付けます:

markdown
---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

次に、ステージ済みの変更があるリポジトリでエージェントを開き、「ステージした内容のコミットメッセージを書いて」と頼みます。エージェントは説明を見て、一致すると判断し、4つのルールを読んで従います。スキルを無視する場合は、まず description を見てください。そこには状況、ここでは「commit」を、あなたが実際に使う言葉で示す必要があります。

1つ注意点があります。スキルはclaude.ai、API、Claude Codeの間で同期されません。ある場所で作ったスキルは、他の場所に別途追加する必要があります。

スキル、AGENTS.md、MCP: それぞれ何が違うか#

この3つはいつも混同されます。AGENTS.md や CLAUDE.md のようなルールファイルはセッション開始時に読まれ、プロジェクトに関する事実を保持します(そのファイルがDownloadsフォルダでどう壊れうるか)。MCPサーバーはエージェントに新しいツールと到達できるデータを与えます(平易な言葉でのMCP)。スキルは手順です。ある種類の作業をどう行うかであり、その作業が出てきたときに読み込まれます。

クイックチェック

20個のスキルをインストールし、今日は1つも使わなかった。コンテキストでどれだけのコストがかかるか?

答えを表示

答え: それぞれ約100トークン。名前と説明の分

名前と説明は常に読み込まれます(ドキュメントによればスキルあたり約100トークン)。本文はスキルがトリガーされたときにだけ読み込まれ、スクリプトのコードはコンテキストに入らず、その出力だけが入ります。

インストール前に第三者のスキルを精査する#

スキルはエージェントが従うテキストであり、ときにエージェントが実行するコードです。ドキュメントは、信頼できる提供元のスキルだけを使い、同梱ファイル(SKILL.md、スクリプト、リソース)をすべて監査し、予期しないネットワーク呼び出しやファイルアクセスを探すよう述べています。外部URLを取得するスキルはより危険です。Claude Codeでは、スキルはあなたのコンピュータ上の他のプログラムと同じネットワークアクセスを持つので、インストールはソフトウェアのインストールと同様に扱ってください。

良い見本はuniversal-modderで、ゲームMOD作成ツールキットです。そのREADME(2026年10月30日確認)は、Agent Skills形式のMITライセンスのスキル群、um というPython CLI、fal経由のアセット生成用MCPサーバー、フィールドノートの共有ナレッジベースを説明しています。メインのスキル mod-any-game は、偵察、リバースエンジニアリング、アセット生成、ゲーム内テスト、パッケージングを扱います。READMEは対応ツールとしてClaude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCodeを挙げ、ツールキットはアンチチートやDRMの回避を拒否すると述べています。Claude Codeでは /plugin marketplace add rehan-remade/universal-modder でインストールされ、アセット生成には別途fal APIキーが必要です。

そのリストに何が含まれているかに注目してください。スキル、コマンドラインプログラム、サーバーです。1つの SKILL.md を読んでも、インストールしているものの一部しかカバーできません。ですから各部分を確認してください:

チェックリスト

他人のスキルをインストールする前に

重要なルールはAPIキーを安全に保存する方法にあります。リポジトリのページには最終コミットの日付が表示されていないので、頼る前にプロジェクトがどれだけ最近更新されたかを確認してください。

タグ: