スキルとは？

Note

エージェントスキルは、専門知識とワークフローを使用して AI エージェントの機能を拡張するための軽量でオープンなフォーマットです。

その核心は、スキルは SKILL.md ファイルを含むフォルダです。このファイルにはメタデータ（最低限 name と description）と、エージェントに特定のタスクを実行する方法を指示する指示が含まれています。スキルはスクリプト、テンプレート、参照資料をバンドルすることもできます。

my-skill/
├── SKILL.md          # 必須：指示 + メタデータ
├── scripts/          # オプション：実行可能コード
├── references/       # オプション：ドキュメント
└── assets/           # オプション：テンプレート、リソース

スキルの仕組み

スキルは、コンテキストを効率的に管理するために漸進的開示を使用します：

  1. 発見：起動時に、エージェントは各利用可能なスキルの名前と説明のみをロードし、関連する可能性がある場合に認識するのに十分です。

  2. アクティベーション：タスクがスキルの説明と一致すると、エージェントは完全な SKILL.md 指示をコンテキストに読み込みます。

  3. 実行：エージェントは指示に従い、必要に応じて参照ファイルをロードしたり、バンドルされたコードを実行したりします。

このアプローチにより、エージェントは高速を維持しながら、オンデマンドでより多くのコンテキストにアクセスできます。

SKILL.md ファイル

すべてのスキルは、YAML フロントマターと Markdown 指示を含む SKILL.md ファイルから始まります：

---
name: pdf-processing
description: PDF ファイルからテキストとテーブルを抽出し、フォームに記入し、ドキュメントをマージします。
---

# PDF 処理

## このスキルを使用するタイミング
ユーザーが PDF ファイルを扱う必要がある場合にこのスキルを使用してください...

## テキストを抽出する方法
1. テキスト抽出には pdfplumber を使用...

## フォームに記入する方法
...

SKILL.md の先頭には、以下のフロントマターが必要です：

  • name：短い識別子
  • description：このスキルを使用するタイミング

Markdown の本文には実際の指示が含まれており、構造や内容に特定の制限はありません。

このシンプルなフォーマットにはいくつかの重要な利点があります：

  • 自己文書化：スキルの作成者またはユーザーは SKILL.md を読んで何をするのかを理解でき、スキルの監査と改善が容易です。

  • 拡張可能：スキルは単なるテキスト指示から実行可能なコード、リソース、テンプレートまで、複雑さの範囲が広がります。

  • ポータブル：スキルは単なるファイルなので、編集、バージョン管理、共有が簡単です。

次のステップ