コアコンセプト

What are Agent Skills?

AIエージェントが世界と信頼できる安全な方法で対話できるようにするモジュール式の能力です。

Agent Skillsは、AIエージェントに新しい能力と専門知識を与えるためのシンプルでオープンなフォーマットです。新入社員向けのオンボーディングガイドのようなもので、手続き的知識、組織的コンテキスト、ベストプラクティスを、エージェントが動的に発見してロードできるモジュール式リソースにパッケージ化します。

機能ユニット

スキルは、'Web検索'や'メール送信'など、エージェントに特定の能力を与える自己完結型のコードパッケージ(プロンプト + ツール)です。

発見可能

標準化されたメタデータで設計されており、ユーザーが関連するタスクを依頼した際に、エージェントが動的に'学習'または'ロード'できます。

標準化

共通のファイル構造(SKILL.md, scripts/)に従い、異なるエージェントフレームワーク間での互換性を確保します。

Agent Skills で何ができますか?

ドメインの専門知識

法的レビュープロセスからデータ分析パイプラインまで、専門知識を再利用可能な指示にパッケージ化します。

新しい機能

エージェントに新しい機能を提供します(例:プレゼンテーションの作成、MCPサーバーの構築、データセットの分析)。

反復可能なワークフロー

複数ステップのタスクを一貫性のある監査可能なワークフローに変換します。

相互運用性

異なるスキル対応エージェント製品間で同じスキルを再利用します。

ソース:agentskills.io

段階的開示:中核的な設計原則

スキルは段階的開示を使用します。これは、目次から始まり、次に特定の章、最後に詳細な付録へと進む、よく整理されたマニュアルのようなものです。エージェントは必要なときにのみ情報をロードし、コンテキストウィンドウを効果的に管理します。

レベル1:メタデータ

起動時に、エージェントはインストールされているすべてのスキルの名前と説明をシステムプロンプトに事前ロードします。これにより、すべてをロードすることなく、各スキルをいつ使用すべきかをエージェントが知るのに十分な情報が提供されます。

レベル2:SKILL.md

エージェントがスキルが現在のタスクに関連していると判断した場合、完全なSKILL.mdをコンテキストに読み込むことでスキルをロードします。これが第2レベルの詳細です。

レベル3+:参照ファイル

スキルが複雑になるにつれて、単一のSKILL.mdに収まりきらないほどのコンテキストを含む場合があります。このような場合、スキルはスキルディレクトリ内に追加ファイルをバンドルでき、エージェントは必要に応じてのみナビゲートして発見できます。

スキルの解剖学

すべてのスキルは、LLMの予測可能性を確保するために厳格な構造に従います。それは単なるコードではなく、セマンティックインターフェースです。

  • 定義ファイル (SKILL.md)
  • Python/Node.js スクリプト
  • アセットディレクトリ
  • メタデータレジストリ
my-awesome-skill/
├── SKILL.md
├── scripts/
│   ├── browser_tool.py
│   └── util.py
├── assets/
└── references/

スキル作成のベストプラクティス

すべきこと
  • 簡潔に保つ - コンテキストウィンドウは公共財です
  • 段階的開示パターンを使用する
  • 複雑なタスクのための明確なワークフローを提供する
  • フィードバックループと検証ステップを実装する
  • 一貫した用語を使用する
すべきでないこと
  • 深くネストされた参照を避ける
  • 時間に敏感な情報を含めない
  • あまりにも多くのオプションを提供しない
  • ツールがインストールされていると仮定しない
  • Windowsスタイルのパスを使用しない

中核原則:簡潔さが鍵

コンテキストウィンドウは公共財です。あなたのスキルは、システムプロンプト、会話履歴、他のスキルのメタデータ、実際のリクエストなど、エージェントが知る必要があるすべてのものとコンテキストウィンドウを共有します。デフォルトの仮定:Claudeはすでに非常に賢いので、Claudeがまだ持っていないコンテキストのみを追加してください。

サポートされているプラットフォーム

お気に入りのエージェントフレームワークにスキルをインストールします。

構築の準備はできましたか?

公式ドキュメントを確認するか、既存のスキルを参照してインスピレーションを得てください。

参考文献