elysai
AI

Agent Skillsとは? — 長いプロンプトなしでAIをもっと賢く使う方法

Alex Nguyen10分

はじめに

AIを業務で活用する場面が増えるにつれ、こんな課題に直面していませんか?

  • プロンプトが長く複雑になりすぎて、管理が大変
  • 毎回同じような指示を繰り返し書いている
  • チームメンバーによってAIの出力品質にばらつきがある

こうした課題を根本から解決するために登場したのが、Agent Skills(エージェントスキル)という新しい仕組みです。

Agent Skillsは、Anthropic社が提唱し、現在はオープンスタンダードとして公開されている技術です。すべての指示を一度にプロンプトに詰め込むのではなく、AIが必要なスキルを必要なタイミングで自動的に読み込むという設計思想に基づいています。

本記事では、Agent Skillsの基本的な仕組みから、Excelファイルのチェックやメール作成といった実務での活用例まで、わかりやすく解説します。

前提条件

本記事の内容をより深く理解するために、以下の前提知識があるとスムーズです。

対象読者

  • AIツール(ChatGPT、Claude等)を業務で使ったことがある方
  • プロンプト作成の基本を理解している方
  • チームでのAI活用を検討しているマネージャー・リーダー

用語の補足

用語説明
プロンプトAIに与える指示文のこと
コンテキストウィンドウAIが一度に処理できるテキストの上限枠
エージェント自律的にタスクを実行できるAIシステム
SKILL.mdスキルの定義ファイル(Markdown形式)

Agent Skillsの説明

従来のアプローチの問題点

image.png

従来、AIに複雑な作業を任せるには、すべての手順・ルール・注意事項を1つの長いプロンプトにまとめて渡す必要がありました。

例:従来のプロンプト(イメージ)
「このExcelファイルを開いて、A列の数値をチェックして、
 空白セルがあればハイライトして、合計値を計算して、
 フォーマットはこうして、エラーがあればこう処理して…」
→ 数百〜数千文字の指示が1つのプロンプトに集中

この方法には大きな問題があります。

  1. コンテキストの圧迫 — 指示が長すぎると、AIの処理能力が分散し、精度が低下する
  2. 再利用性がない — 毎回同じ指示を手動で入力し直す必要がある
  3. スケーラビリティの限界 — 対応業務が増えるたびにプロンプトが肥大化し、管理不能になる

Agent Skillsの仕組み

Agent Skillsは、この問題を「Progressive Disclosure(段階的開示)」という設計原則で解決します。

新入社員のオンボーディングに例えると、わかりやすいかもしれません。入社初日にすべてのマニュアルを一度に渡すのではなく、目次だけを最初に渡して、必要になった章だけを読んでもらうというイメージです。

3段階の情報ロード

レベル1:スキルの「名前」と「説明」だけをシステムプロンプトに登録
         → AIは "どんなスキルがあるか" を把握する(トークン消費:最小限)

レベル2:タスクに関連するスキルが見つかったら、SKILL.mdの本文を読み込む
         → AIは "具体的に何をすべきか" を理解する

レベル3:さらに詳細な手順が必要なら、参照ファイルやスクリプトを追加で読み込む
         → AIは "どう実行するか" の細部まで把握する

つまり、10個のスキルがインストールされていても、実際に使われるのはタスクに必要な1〜2個だけ。コンテキストウィンドウを無駄に消費せず、必要な知識だけを効率的にロードするのがAgent Skillsの最大の特徴です。

スキルの構造

スキルの実体は、SKILL.mdというMarkdownファイルを含むフォルダです。

# SKILL.mdの基本構造
---
name: excel-checker
description: Excelファイルのデータ検証・整合性チェックを行うスキル。
             ユーザーが「Excelをチェックして」と言ったときに使用する。
---

# Excel Checker

## 手順
1. ファイルを開き、シート構造を確認する
2. 各列のデータ型を検証する
3. 空白セル・異常値を検出する
...

ポイントは、namedescriptionの部分(YAMLフロントマター)です。AIはまずこの部分だけを読み、ユーザーのリクエストに関連するスキルかどうかを判断します。関連があると判断した場合のみ、本文の手順を読み込みます。

例と各ステップ

ここでは、実務でよくある2つのシーンを例に、Agent Skillsがどのように動作するかを具体的に見ていきます。

例1:Excelファイルの自動チェック

シチュエーション: クライアントから受領した見積データ(Excel)に不備がないかチェックしたい。

従来のやり方(スキルなし):

ユーザーが毎回、以下のような長いプロンプトを書く必要があります。

「このExcelファイルを開いてください。
 シート1のA列が商品コード、B列が単価、C列が数量、D列が小計です。
 以下をチェックしてください:
 ・空白セルがないか
 ・B列×C列=D列になっているか
 ・商品コードが重複していないか
 ・単価がマイナスになっていないか
 問題があればリストアップして、修正案も提示してください。」

Agent Skillsを使ったやり方:

事前にexcel-checkerスキルを作成・登録しておけば、ユーザーは以下の一言だけで済みます。

「このExcelファイルをチェックして」

AIの内部処理ステップ:

Step 1: ユーザーのメッセージを受信
        → 「Excelをチェックして」というリクエストを認識

Step 2: インストール済みスキル一覧からマッチするものを探す
        → excel-checkerスキルの description が一致
        → SKILL.mdの本文を読み込む(レベル2)

Step 3: SKILL.mdの手順に従い、Excelファイルを解析
        → 必要に応じてPythonスクリプト(バンドル済み)を実行
        → スクリプトはコンテキストに読み込まず直接実行(効率的)

Step 4: チェック結果をユーザーにレポートとして出力
        → 空白セル:C12, C15
        → 計算不一致:D8(期待値: 15,000 / 実際値: 14,500)
        → 重複コード:A3とA17が同一

▼ フロー図:Excelチェックの処理イメージ

agent_skills_excel_flow_main.svg

💡 従来は毎回200〜500文字のプロンプトが必要でしたが、Agent Skillsなら一言で同じ結果が得られます。

例2:ビジネスメールの自動作成

シチュエーション: 日本のクライアントに対して、プロジェクトの進捗報告メールを作成したい。

従来のやり方(スキルなし):

「以下の条件でメールを書いてください。
 ・宛先:〇〇株式会社 △△様
 ・件名:【月次報告】4月度開発進捗について
 ・トーン:丁寧なビジネス日本語
 ・構成:挨拶→進捗サマリー→課題→次月計画→締め
 ・敬語レベル:尊敬語+謙譲語を適切に使用
 ・本文にはこの情報を含めてください:(タスク一覧、進捗率、課題…)」

Agent Skillsを使ったやり方:

事前にjp-business-emailスキルを登録しておけば、こう指示するだけです。

「△△様に4月度の進捗報告メールを書いて。タスクAは完了、タスクBは80%、課題はリソース不足。」

AIの内部処理ステップ:

Step 1: ユーザーのメッセージを受信
        → メール作成のリクエストを認識

Step 2: スキル一覧を確認
        → jp-business-emailスキルの description が一致
        → SKILL.mdを読み込み、メールのフォーマット・敬語ルールを取得

Step 3: 必要に応じて参照ファイルを追加読み込み(レベル3)
        → templates/monthly-report.md(月次報告テンプレート)
        → references/keigo-guide.md(敬語の使い分けガイド)

Step 4: テンプレートとルールに基づいてメールを生成
        → 件名、宛名、挨拶文、本文、署名まで一貫したフォーマットで出力

スキルありvs.スキルなし — 比較まとめ

観点スキルなしスキルあり
ユーザーの入力量毎回、詳細な指示が必要最小限のキーワードで十分
出力の一貫性指示の書き方により変動スキル定義に基づき安定
チーム間の品質差プロンプトのスキルに依存誰が使っても同じ品質
メンテナンスプロンプトの管理が煩雑SKILL.mdを更新するだけ
拡張性プロンプトが際限なく肥大化スキルを追加するだけでOK

まとめ

Agent Skillsは、AIの使い方を「毎回長いプロンプトを書く」から「必要なスキルを自動でロードする」へと転換させる仕組みです。

主なメリットを整理すると:

  • 効率性 — コンテキストウィンドウを無駄にしない段階的な情報ロード
  • 再利用性 — 一度作ったスキルは何度でも、誰でも使える
  • 一貫性 — 同じスキルを使えば、チーム全体で出力品質が均一化
  • 拡張性 — 新しいスキルを追加するだけで、AIの対応範囲が広がる
  • ポータビリティ — オープンスタンダード規格のため、異なるAIプラットフォーム間での互換性あり

特に、日本のクライアントとやり取りをする業務では、敬語の使い分け・メールフォーマット・ドキュメントの品質基準など、暗黙知として属人化しやすいノウハウをスキルとして形式知化できることが大きな価値です。

Agent Skillsは現在、Claude.ai、Claude Code、Claude API、そしてClaude Agent SDKで利用可能です。また、OpenAI CodexやGemini CLIなど、他のプラットフォームでも採用が進んでいます。

AIを「便利なチャットツール」から「チームの即戦力メンバー」に変えたい方は、ぜひAgent Skillsの導入を検討してみてください。

📎 参考リンク
- Agent Skills 公式ドキュメント(Anthropic)
- Agent Skills オープンスタンダード
- Skills リポジトリ(GitHub)
- DeepLearning.AI — Agent Skills with Anthropic(無料コース)
Share this post

Author

Alex Nguyen

Book Free AI Assessment

Book Free AI Assessment