capabilities-txt-registry

capabilities.txt

ウェブサイトが何を実行できるか――エージェントが発見して呼び出せる機能――を、周知の場所で宣言するための、シンプルでオープンな規約です。

ウェブは、機械が段階的に情報を読み取る方法を教えてきました。robots.txt はクローラーがアクセスしてよいものを示します。sitemap.xml は存在するものを示します。llms.txt は読む価値のあるものを示します。それぞれ、自動化された読み手の狭い質問に答えます。

しかし、エージェントが今尋ねる質問には、どれも答えていません。このホストは実際に何を実行できるのか？

エージェントは、ウェブを読むだけでなく、ウェブ上で行動するようになりました。サイトにアクセスしたエージェントはドキュメントを要約できますが、「サポートチケットを作成する」機能、「在庫を確認する」機能、「返品を開始する」機能が提供されていることや、その呼び出し方法を標準的な手段で発見できません。現在は、ベンダーごとに個別の統合を行うことで実現しています。

capabilities.txt は、欠けていたレイヤーです。ホストが提供する機能を宣言し、あらゆるエージェントが実行可能なことを発見できるようにする、公開された周知のファイルです。

意図的に小規模な仕様にしています。llms.txt がうまく機能したのは、午後のうちに導入できたからです。capabilities.txt も同じ方針に従います。

2 つの形式

ホストは、次の一方または両方を公開します。

• /capabilities.txt — 人間とエージェントが読めるマークダウン形式です。機能をカテゴリごとにまとめ、それぞれに ID、バージョン、1 行の説明を記載します。
• /.well-known/capabilities.json — 構造化形式です。機能参照の配列で構成され、各参照から完全な記述子を解決できます。

マークダウン形式は、機能の発見と閲覧に使います。JSON 形式は、構造化データを必要とする機械向けです。まずマークダウン形式だけを公開するのも、十分に有効な始め方です。

形式（/capabilities.txt）

# capabilities.txt

> One sentence: what this host is and what kind of capabilities it offers.
> Structured form: https://example.com/.well-known/capabilities.json

## <Category>

### <Group name> (<group-id>)

- <capability-id> (v<version>) — <one-line description>
- <capability-id> (v<version>) — <one-line description>

必要最小限のルールは次のとおりです。

1. 1 行目は # capabilities.txt です。
2. 続いて引用（>）形式の要約を記載します。ホストが提供するものを 1 文で説明し、任意でリンク（JSON 形式、ドキュメント、呼び出しエンドポイント）を追加できます。
3. ## 見出しで機能をカテゴリごとにまとめます（カテゴリ名は自由に選べます）。
4. ### 見出しでグループ名を記載し、任意で安定した (group-id) を付けます。
5. 各機能はリスト項目として記載します。安定した capability-id、任意の (v<version>)、短い — description で構成します。
6. 通常のマークダウンです。人間が読めて、エージェントが解析できれば有効です。

構造化形式（/.well-known/capabilities.json）

{
  "version": "1",
  "capabilities": [
    {
      "id": "support.create_ticket",
      "version": "1.2.0",
      "description": "Open a support ticket",
      "descriptor": "https://example.com/.well-known/capabilities/support.create_ticket.json"
    }
  ]
}

各エントリは参照です。任意の descriptor は、入力、権限、呼び出し方法を記述した、機械可読な完全版を指します。

標準における位置づけ

ファイル	答える質問	対象
robots.txt	クローラーは何にアクセスできますか？	クローラー
sitemap.xml	どのページが存在しますか？	検索エンジン
llms.txt	何を読む価値がありますか？	読み取りを行う LLM
capabilities.txt	このホストは何を実行できますか？	行動するエージェント

これは MCP や API 仕様の代替ではありません。Model Context Protocol はステートフルな接続・呼び出しプロトコルであり、OpenAPI は HTTP API を記述します。capabilities.txt は呼び出しの前段にあたるレイヤーです。エージェント（または検索エンジン）がライブ接続なしで読み取れる、静的で公開されたクロール可能な告知であり、実際の呼び出し先となる MCP サーバー、HTTP API、その他のエンドポイントを示します。発見と呼び出しは別の役割です。capabilities.txt は発見を担い、呼び出しは次の段階へ引き継ぎます。

導入する

最速の方法（仕様書なし）： capabilitiestxt.org/implement のプロンプトをコピーし、 AI コーディングエージェントに渡すと、コードから capabilities.txt を作成してくれます。

OpenAPI 仕様書をお持ちですか？ ブラウザーで生成 （URL を貼り付けてください）するか、GitHub Action を使って CI で自動的に最新の状態に保ちましょう。

- uses: capabilityhostprotocol/capabilities-txt/action@main
  with:
    openapi: https://api.yoursite.com/openapi.json
    output: public/capabilities.txt

次に、capabilitiestxt.org/submit でチェックして、 評価、修正案、バッジを受け取りましょう。ディレクトリとマップから見つけられるようになります。

手動で行う場合：

1. サイトが公開している（または公開できる）機能を列挙します。
2. 上記の形式で /capabilities.txt に記述します。
3. 必要に応じて /.well-known/capabilities.json を公開します。
4. プルリクエストで adopters.md に追加します。

OpenAPI 仕様書をすでにお持ちですか？ 手動で作成せずに生成できます。

python tools/from_openapi.py https://api.yoursite.com/openapi.json > capabilities.txt
python tools/validate.py capabilities.txt   # check it

実際に稼働している capabilities.txt と、さまざまな市場（e コマース、サポート、銀行、医療、開発プラットフォーム）向けの参考テンプレートを含む実用例は、 examples/ にあります。tools/ のツールでファイルを生成、検証できます。

今後の展開

発見は最初のステップです。エージェントが「何ができるか」を把握した後に続くのは、「許可されているか」「何が起きたか」「それを証明できるか」という問いです。これらは、呼び出し、ガバナンス、証拠に関わります。これらを定めるのが、 Capability Host Protocol (CHP) です。これは、capabilities.txt が自然な公開窓口となるオープンプロトコルです。capabilities.txt 単独で導入することもできます。さらに必要な場合に、その先にあるのが CHP です。

ステータスとライセンス

これは動作するリファレンスを備えた提案であり、完成した標準ではありません。皆さまからのフィードバックをお待ちしています。Issue または PR をお寄せください。

• 仕様書とサイトのテキスト（README.md、index.html、SPEC.md）：CC BY 4.0 — LICENSE-DOCS を参照してください。
• ツール（tools/）：Apache-2.0 — LICENSE を参照してください。
• 「capabilities.txt」は自由に使えるオープンな規約です。自由にご利用ください。（商標ではありません。）

Copyright © 2026 Project Auxo, Inc. and contributors.