zurats/agent-skills-discovery-rfc

agent-skills-discovery-rfc は何をしますか？

🕵️♂️ ウェルノウンURIを使用してエージェントスキルを簡単に発見し、多様なプラットフォームやリソース間でのアクセスと実装を効率化します。

概要

このRFC（Request for Comments）は、AIエージェントスキルの発見と統合を標準化するための仕様を提案します。/.well-known/skills のような既存のウェルノウンURIメカニズムを活用することで、開発者は異なるエコシステム間で一貫した方法でスキルを公開・発見できます。

目的

• 複数のプラットフォーム（Claude Code、Cursor、Codexなど）間でのスキルディスカバリを統一する。
• スキル定義（メタデータ、エンドポイント、依存関係）の標準フォーマットを提供する。
• 手動設定やプロプライエタリなレジストリに依存しない、シンプルな発見メカニズムを可能にする。

仕様

ウェルノウンURI

スキルプロバイダーは、以下のウェルノウンURIでスキル定義ファイルを公開する必要があります。

https://example.com/.well-known/skills

レスポンス形式

スキル定義ファイルは、JSON形式で以下の構造を持つ必要があります。

{
  "skills": [
    {
      "id": "com.example.my-skill",
      "version": "1.0.0",
      "name": "My Skill",
      "description": "A sample skill",
      "entrypoint": "https://example.com/skills/my-skill.js",
      "platforms": ["claude-code", "cursor", "codex"],
      "dependencies": {}
    }
  ]
}

発見プロセス

1. エージェントは、ターゲットホストの /.well-known/skills に対してHTTP GETリクエストを送信します。
2. サーバーはスキル定義のJSON配列を返します。
3. エージェントは定義に基づいてスキルを登録・実行します。

ユースケース

• リポジトリ: GitHub PagesやRawリポジトリでホストし、エージェントが自動的にスキルを発見できるようにする。
• 組織内: 企業内のツールチェーンで標準スキルを公開し、開発チーム間で共有する。
• コミュニティ: オープンソーススキルのカタログを構築する。

実装例

CLIツールを使用した検証

curl https://example.com/.well-known/skills

JavaScriptでのクライアント例

const response = await fetch('https://example.com/.well-known/skills');
const data = await response.json();
console.log(data.skills);

貢献

このRFCは議論と改良のためにあります。フィードバックやプルリクエストを歓迎します。変更内容を明確にし、このドキュメントの範囲を尊重してください。

ライセンス

MIT