agent-ready-cloudflare

エージェント対応 — Cloudflare スキャナー

Web サイトが AI エージェントに対応しているかを監査し、実行可能な修正プロンプトを生成して、エージェント対応スコアを向上させる改善を実装します。

---

0. 運用フロー

このスキルが有効になるたびに、以下のフローに従ってください。

Step 1 — ドメインを取得する

ユーザーがドメインを指定していない場合は、次のように尋ねます。

isitagentready.com でスキャンするドメインを指定してください。

Step 2 — API 経由でスキャンする

curl -s -X POST 'https://isitagentready.com/api/scan' \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36' \
  -H 'Referer: https://isitagentready.com/' \
  -H 'Origin: https://isitagentready.com' \
  -d '{"url":"https://DOMAIN/","enabledChecks":["robotsTxt","sitemap","linkHeaders","dnsAid","markdownNegotiation","robotsTxtAiRules","contentSignals","webBotAuth","apiCatalog","oauthDiscovery","oauthProtectedResource","authMd","mcpServerCard","a2aAgentCard","agentSkills","webMcp","ard","personalAgentProtocol","x402","mpp","ucp","acp","ap2"]}'

DOMAIN を対象のドメインに置き換えます。

Step 3 — Markdown レポートを生成する

API レスポンスを使って、次の構成でレポートを作成します。

# Agent Ready Scan — {domain}

> **Score:** Level {level} — {levelName}
> **Scanned:** {scannedAt}
> **Link:** [View online](https://isitagentready.com/{domain})

## Summary

| Category | Score |
|----------|-------|
| Discoverability | {passed}/{total} |
| Content | {passed}/{total} |
| Bot Access Control | {passed}/{total} |
| API, Auth, MCP & Skill Discovery | {passed}/{total} |
| Commerce (Optional) | {passed}/{total} |

## Details

### Discoverability ({passed}/{total})

- ✅ **robots.txt** — {message}
- ❌ **sitemap.xml** — {message}
  (... for each check ...)

### (... repeat for each category ...)

## 🔧 How to Implement — Agent Prompts

(... one block per failing check, see Step 4 ...)

## Next Level

**Level {nextLevel.target} — {nextLevel.name}**

To reach the next level, implement:
- {nextLevel.requirements[].description}

Step 4 — 「実装方法」プロンプトを生成する

status: "fail" または status: "neutral" のチェックごとに、以下のセクション 8 のプロンプトテンプレートを使用して、プロンプトブロックを生成します。プロンプトには次の内容を含めます。

1. テンプレートのGoalとFix（チェックごとに固定）
2. API レスポンスのIssue（checks.{category}.{check}.message）
3. サブスキルを示すSkill URL
4. 関連する RFC／仕様へのDocsリンク

コーディングエージェントにコピーして貼り付けられるよう、各プロンプトをフェンス付きコードブロックとして出力します。

#### ❌ {check name}

**Issue:** {message from API}

```
Goal: {goal from template}

Issue: {message from API}

Fix: {fix from template}

Skill: https://isitagentready.com/.well-known/agent-skills/{skill-folder}/SKILL.md

Docs: {docs URLs from template}
```

> 📖 Reference: [{skill-folder}/SKILL.md]({skill-folder}/SKILL.md)

Step 5 — 提示する

Markdown レポート全体をユーザーに提示します。ファイルへの保存を希望する場合は、指定されたパスに書き込みます。

---

1. チェック項目

発見可能性（4 項目）

チェック	API キー	合格基準
robots.txt	robotsTxt	text/plain を返し、少なくとも 1 つの User-agent ディレクティブを含む 200 応答であること
sitemap.xml	sitemap	/sitemap.xml が有効な XML を返すか、robots.txt に Sitemap ディレクティブがあること
Link ヘッダー	linkHeaders	ホームページに、エージェントに役立つ関係（service-desc、api-catalog など）を示す Link ヘッダーが含まれていること
DNS-AID	dnsAid	DNS-over-HTTPS 経由で _agents 名前空間の SVCB／HTTPS レコードが見つかること（Cloudflare から Google へフォールバック）

コンテンツ（1 項目）

チェック	API キー	合格基準
エージェント向け Markdown	markdownNegotiation	Accept: text/markdown に対して Content-Type: text/markdown が返されること

ボットのアクセス制御（3 項目）

チェック	API キー	合格基準
AI ボットルール	robotsTxtAiRules	robots.txt に、既知の AI ボット（GPTBot、Claude-Web、Google-Extended など）の User-agent エントリーが含まれていること
コンテンツシグナル	contentSignals	robots.txt に、ai-train/search/ai-input を指定する Content-Signal ディレクティブが含まれていること
Web Bot Auth	webBotAuth	/.well-known/http-message-signatures-directory が有効な JWKS とともに存在すること（参考情報 — neutral はスコアに影響しません）

API、認証、MCP、スキルの検出（10 項目）

項目	API キー	合格基準
API カタログ	apiCatalog	/.well-known/api-catalog が API エントリーを含む有効な linkset+json を返す
OAuth/OIDC	oauthDiscovery	/.well-known/openid-configuration または oauth-authorization-server に有効な OAuth メタデータがある
OAuth 保護リソース	oauthProtectedResource	/.well-known/oauth-protected-resource に resource と authorization_servers がある
Auth.md	authMd	/auth.md が存在し、有効な H1 見出しに「auth.md」が含まれる。任意で PRM と AS のメタデータを含める
MCP サーバーカード	mcpServerCard	/.well-known/mcp/server-card.json、server-cards.json、または mcp.json に serverInfo.name を含む有効なカードがある
A2A エージェントカード	a2aAgentCard	/.well-known/agent-card.json に name、version、supportedInterfaces がある
エージェントスキルのインデックス	agentSkills	/.well-known/agent-skills/index.json に有効な skills 配列がある（従来の /.well-known/skills/ も受け付けます）
WebMCP	webMcp	ページが navigator.modelContext.provideContext() を通じて MCP ツールを公開している
ARD	ard	/.well-known/ai-catalog.json に specVersion、host、空でない entries がある
パーソナルエージェントプロトコル（Poppy）	personalAgentProtocol	/.well-known/poppy.json（draft 0.1）に有効な organization／domain とインターフェースがある。認証が宣言されている場合、ドメインが poppy_domains に含まれるメタデータを持つ、一致する OAuth 発行者が必要です（情報提供のみ — レベルやスコアには影響しません）

コマース — 任意（5 項目。E コマースのシグナルが検出された場合のみスコアに加算）

項目	API キー	合格基準
x402	x402	API ルートが、有効な x402 決済ヘッダーとともに HTTP 402 を返す
MPP	mpp	/openapi.json の、決済可能なオペレーションに x-payment-info 拡張がある（Machine Payment Protocol）
UCP	ucp	/.well-known/ucp に protocol_version と services がある
ACP	acp	/.well-known/acp.json に protocol.name、api_base_url、transports、capabilities.services がある
AP2	ap2	A2A エージェントカードに、ロール情報を含む AP2 拡張がある

---

2. レベル

レベル	名前	要件
0	未対応	レベル 1 の基準を満たしていない
1	基本的な Web プレゼンス	次の 3 項目中 2 項目に合格：robots.txt、サイトマップ、リンクヘッダー
2	ボット対応	レベル 1 ＋ 両方：AI ボットのルールと、robots.txt の Content Signals
3	エージェントが読み取り可能	レベル 2 ＋ Markdown のコンテンツネゴシエーション
4	エージェント連携	レベル 3 ＋ 次の 4 項目中 1 項目：MCP サーバーカード、A2A エージェントカード、エージェントスキル、API カタログ
5	エージェントネイティブ	レベル 4 ＋ 次の 3 項目中 2 項目：Web Bot Auth、すべての連携、認証メタデータ（OAuth または Auth.md）

---

3. API リファレンス

エンドポイント

POST https://isitagentready.com/api/scan
Content-Type: application/json

必須ヘッダー（Cloudflare による保護）

User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36
Referer: https://isitagentready.com/
Origin: https://isitagentready.com

リクエスト本文

{
  "url": "https://example.com/",
  "enabledChecks": [
    "robotsTxt", "sitemap", "linkHeaders", "dnsAid",
    "markdownNegotiation",
    "robotsTxtAiRules", "contentSignals", "webBotAuth",
    "apiCatalog", "oauthDiscovery", "oauthProtectedResource", "authMd",
    "mcpServerCard", "a2aAgentCard", "agentSkills", "webMcp", "ard",
    "personalAgentProtocol",
    "x402", "mpp", "ucp", "acp", "ap2"
  ]
}

すべてのチェックは任意です — 実行したいものだけを渡してください。

"format": "agent" を設定すると、JSON の代わりに修正手順を含む Markdown のレスポンスが返されます （LLM に直接パイプで渡す場合に便利です）。

MCP サーバー

スキャナーは MCP サーバーとしても利用できます：

https://isitagentready.com/mcp

url パラメーターを指定して scan_site ツールを呼び出してください。scan-site/SKILL.md を参照してください。

検出されたエンドポイント（isitagentready.com 自体）

スキャナーは、自らの推奨事項を実践しています。以下は、スキャナー自身が備えるエージェント対応エンドポイントです。

エンドポイント	内容
/.well-known/api-catalog	スキャン API と MCP サーバーのエントリーを含む RFC 9727 リンクセット
/.well-known/mcp/server-card.json	MCP Server Card（Streamable HTTP トランスポート）
/.well-known/mcp.json	同じ MCP Server Card（別のパス）
/.well-known/agent-skills/index.json	Agent Skills Discovery v0.2.0 形式の 25 個のスキル
/llms.txt	スキャナーの LLM 向け概要
/llms-full.txt	全 23 項目のチェック、合格基準、レベルシステムに関する正規のリファレンスとなる完全なドキュメント
/api/health	ヘルスチェック（{"status":"ok"}）
/mcp	scan_site ツールを備えた Streamable HTTP MCP サーバー

API Catalog は、スキャン API をそのドキュメント（/llms-full.txt）、 サービスの説明（/.well-known/mcp/server-card.json）、ヘルス エンドポイント（/api/health）にリンクします。

レスポンス構造

{
  "url": "https://example.com",
  "scannedAt": "2026-04-18T13:10:58.788Z",
  "level": 1,
  "levelName": "Basic Web Presence",
  "isCommerce": false,
  "commerceSignals": [],
  "nextLevel": {
    "target": 2,
    "name": "Bot-Aware",
    "requirements": [
      {
        "check": "contentSignals",
        "description": "...",
        "shortPrompt": "...",
        "prompt": "Full implementation prompt...",
        "specUrls": ["https://..."],
        "skillUrl": "https://isitagentready.com/.well-known/agent-skills/.../SKILL.md"
      }
    ]
  },
  "checks": {
    "<category>": {
      "<checkKey>": {
        "status": "pass|fail|neutral",
        "message": "Human-readable conclusion",
        "durationMs": 42,
        "evidence": [
          {
            "action": "fetch|parse|conclude",
            "label": "GET /robots.txt",
            "request": { "url": "...", "method": "GET" },
            "response": {
              "status": 200,
              "headers": { "content-type": "..." },
              "bodyPreview": "..."
            },
            "finding": {
              "outcome": "positive|negative|neutral",
              "summary": "..."
            }
          }
        ]
      }
    }
  }
}

ステータス値

ステータス	アイコン	意味
pass	✅	チェックに合格しました
fail	❌	対応が必要です
neutral	⬜	該当なし／情報提供のみ

---

4. Web インターフェースと API の比較

機能	API	Web UI
スコアとレベル	✅	✅
チェックのステータスとメッセージ	✅	✅
エビデンス（監査の詳細）	✅ 全て	✅ 同じ内容
「実装方法」のプロンプト	⚠️ nextLevel のみ（1 件のプロンプト）	✅ 不合格のチェックすべて
スキル URL	⚠️ nextLevel のみ	✅ すべてのチェック

そのため、このスキルには以下に完全なプロンプトテンプレートが含まれています。これにより、API データから Web 品質のプロンプトを再構成できます。

---

5. バッチスキャン

複数のドメインをスキャンする場合は、リクエストの間に 2 秒の遅延を入れてください。データの損失を防ぐため、結果は逐次書き込んでください。

import json, time, urllib.request

HEADERS = {
    "Content-Type": "application/json",
    "User-Agent": "Mozilla/5.0 ...",
    "Referer": "https://isitagentready.com/",
    "Origin": "https://isitagentready.com"
}
CHECKS = ["robotsTxt","sitemap","linkHeaders","dnsAid","markdownNegotiation",
          "robotsTxtAiRules","contentSignals","webBotAuth","apiCatalog",
          "oauthDiscovery","oauthProtectedResource","authMd","mcpServerCard",
          "a2aAgentCard","agentSkills","webMcp","ard","personalAgentProtocol",
          "x402","mpp","ucp","acp","ap2"]

for domain in domains:
    body = json.dumps({"url": f"https://{domain}/", "enabledChecks": CHECKS}).encode()
    req = urllib.request.Request("https://isitagentready.com/api/scan",
                                data=body, headers=HEADERS)
    with urllib.request.urlopen(req, timeout=90) as resp:
        data = json.loads(resp.read())
    # process data...
    time.sleep(2)

---

6. サブスキル（実装ガイド）

検出可能性

• robots-txt/SKILL.md — /robots.txt を公開します（RFC 9309）
• sitemap/SKILL.md — /sitemap.xml を公開します
• link-headers/SKILL.md — Link レスポンスヘッダーを追加します（RFC 8288）
• dns-aid/SKILL.md — エージェントによる検出のため DNS-AID SVCB レコードを公開します（draft-mozleywilliams-dnsop-dnsaid）
• llms-txt/SKILL.md — /llms.txt を公開します（llmstxt.org）
• llms-full-txt/SKILL.md — /llms-full.txt を公開します

コンテンツ

• markdown-negotiation/SKILL.md — Accept: text/markdown に対して Markdown を返します

ボットのアクセス制御

• ai-rules/SKILL.md — robots.txt の AI ボット向け User-agent ルール
• content-signals/SKILL.md — Content-Signal ディレクティブ
• web-bot-auth/SKILL.md — リクエスト署名用 JWKS

API、認証、MCP、スキル検出

• api-catalog/SKILL.md — API Catalog（RFC 9727）
• oauth-discovery/SKILL.md — OAuth/OIDC 検出（RFC 8414）
• oauth-protected-resource/SKILL.md — Protected Resource Metadata（RFC 9728）
• auth-md/SKILL.md — Auth.md エージェント登録の検出（auth-md.com）
• mcp-server-card/SKILL.md — MCP Server Card（SEP-1649）
• a2a-agent-card/SKILL.md — A2A Agent Card（Google A2A Protocol）
• agent-skills/SKILL.md — Agent Skills Discovery Index
• webmcp/SKILL.md — WebMCP ブラウザー API
• ard/SKILL.md — ARD / ai-catalog（Agentic Resource Discovery）
• personal-agent-protocol/SKILL.md — Personal Agent Protocol（Poppy）の検出（情報提供のみ）

コマース（任意）

• x402/SKILL.md — x402 HTTP 決済プロトコル
• mpp/SKILL.md — Machine Payment Protocol（mpp.dev）
• ucp/SKILL.md — Universal Commerce Protocol
• acp/SKILL.md — Agent Commerce Protocol

メタ

• scan-site/SKILL.md — あらゆるサイトのエージェント対応状況をスキャンします（MCP サーバーのエンドポイントを含みます）

---

7. 最大限の効果を得るための優先順位

1. robots.txt + sitemap.xml → レベル 1
2. robots.txt の Content Signals → レベル 2
3. Markdown for Agents + Link headers → レベル 3 を目指します
4. MCP Server Card + Agent Skills Index → レベル 4 を目指します
5. OAuth discovery + API Catalog → 完全なエージェント相互運用性

---

8. チェックごとのプロンプトテンプレート

これらのテンプレートは、ウェブ UI の「実装方法 — コーディングエージェントに貼り付ける」プロンプトを再現したものです。レポートの生成時（ステップ 4）には、{issue} プレースホルダーを API レスポンスの実際の message に置き換えてください。

robotsTxt

Goal: Publish /robots.txt with clear crawl rules

Issue: {issue}

Fix: Create /robots.txt at the site root with explicit User-agent directives and allow/disallow rules for key paths. Ensure it is plain text and returns 200.

Skill: https://isitagentready.com/.well-known/agent-skills/robots-txt/SKILL.md

Docs: https://www.rfc-editor.org/rfc/rfc9309

サブスキル：robots-txt/SKILL.md

sitemap

Goal: Publish /sitemap.xml with canonical URLs

Issue: {issue}

Fix: Generate /sitemap.xml listing canonical URLs, keep it updated on publish, and reference it from /robots.txt.

Skill: https://isitagentready.com/.well-known/agent-skills/sitemap/SKILL.md

Docs: https://www.sitemaps.org/protocol.html

サブスキル：sitemap/SKILL.md

linkHeaders

Goal: Include Link response headers for agent discovery (RFC 8288)

Issue: {issue}

Fix: Add Link response headers to your homepage that point agents to useful resources. For example: Link: </.well-known/api-catalog>; rel="api-catalog" to advertise your API catalog, or Link: </docs/api>; rel="service-doc" for API documentation. See RFC 8288 for the Link header format and IANA Link Relations for registered relation types.

Skill: https://isitagentready.com/.well-known/agent-skills/link-headers/SKILL.md

Docs: https://www.rfc-editor.org/rfc/rfc8288, https://www.rfc-editor.org/rfc/rfc9727#section-3

サブスキル：link-headers/SKILL.md

markdownNegotiation

Goal: Return HTML responses as markdown when agents request it

Issue: {issue}

Fix: Enable Markdown for Agents so requests with Accept: text/markdown return a markdown version of your HTML response while HTML stays the default for browsers. Confirm the response uses Content-Type: text/markdown (and x-markdown-tokens if available).

Skill: https://isitagentready.com/.well-known/agent-skills/markdown-negotiation/SKILL.md

Docs: https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/

サブスキル：markdown-negotiation/SKILL.md

robotsTxtAiRules

Goal: Add User-agent rules for AI crawlers like GPTBot, Claude-Web, and others

Issue: {issue}

Fix: Add explicit User-agent entries for AI crawlers (GPTBot, OAI-SearchBot, Claude-Web, Google-Extended) with allow/disallow rules that match your policy.

Skill: https://isitagentready.com/.well-known/agent-skills/ai-rules/SKILL.md

Docs: https://www.rfc-editor.org/rfc/rfc9309, https://developers.cloudflare.com/ai-crawl-control/

サブスキル：ai-rules/SKILL.md

contentSignals

Goal: Declare AI content usage preferences with Content Signals in robots.txt

Issue: {issue}

Fix: Add Content-Signal directives to your robots.txt declaring preferences for ai-train, search, and ai-input. For example:
Content-Signal: ai-train=no, search=yes, ai-input=no

Skill: https://isitagentready.com/.well-known/agent-skills/content-signals/SKILL.md

Docs: https://contentsignals.org/, https://datatracker.ietf.org/doc/draft-romm-aipref-contentsignals/

サブスキル：content-signals/SKILL.md

webBotAuth

Goal: Let your site identify itself as a bot with Web Bot Auth

Issue: {issue}

Fix: Publish a JWKS at /.well-known/http-message-signatures-directory so your site can identify itself when it sends bot or agent requests. Receiving sites can use it to verify those signed requests.

Skill: https://isitagentready.com/.well-known/agent-skills/web-bot-auth/SKILL.md

Docs: https://datatracker.ietf.org/wg/webbotauth/about/, https://developers.cloudflare.com/bots/reference/bot-verification/web-bot-auth/

サブスキル：web-bot-auth/SKILL.md

apiCatalog

Goal: Publish an API catalog for automated API discovery (RFC 9727)

Issue: {issue}

Fix: Create /.well-known/api-catalog returning application/linkset+json with a "linkset" array. Each entry should include an "anchor" URL for the API and link relations for service-desc (OpenAPI spec), service-doc (documentation), and status (health endpoint). See RFC 9727 Appendix A for examples.

Skill: https://isitagentready.com/.well-known/agent-skills/api-catalog/SKILL.md

Docs: https://www.rfc-editor.org/rfc/rfc9727, https://www.rfc-editor.org/rfc/rfc9264

サブスキル：api-catalog/SKILL.md

oauthDiscovery

Goal: Publish OAuth/OIDC discovery metadata so agents can authenticate with your APIs

Issue: {issue}

Fix: If your site has protected APIs, publish /.well-known/openid-configuration (for OpenID Connect) or /.well-known/oauth-authorization-server (for pure OAuth 2.0) with your issuer, authorization_endpoint, token_endpoint, jwks_uri, and grant_types_supported. This allows AI agents to programmatically discover how to authenticate.

Skill: https://isitagentready.com/.well-known/agent-skills/oauth-discovery/SKILL.md

Docs: http://openid.net/specs/openid-connect-discovery-1_0.html, https://www.rfc-editor.org/rfc/rfc8414

サブスキル：oauth-discovery/SKILL.md

oauthProtectedResource

Goal: Publish OAuth Protected Resource Metadata so agents can discover how to authenticate

Issue: {issue}

Fix: Publish /.well-known/oauth-protected-resource with your resource identifier, authorization_servers (list of OAuth/OIDC issuer URLs that can issue tokens for this resource), and scopes_supported. This tells agents how to obtain access tokens for your protected APIs.

Skill: https://isitagentready.com/.well-known/agent-skills/oauth-protected-resource/SKILL.md

Docs: https://www.rfc-editor.org/rfc/rfc9728

サブスキル：oauth-protected-resource/SKILL.md

mcpServerCard

Goal: Publish an MCP Server Card for agent discovery

Issue: {issue}

Fix: Serve an MCP Server Card (SEP-1649) at /.well-known/mcp/server-card.json with serverInfo (name, version), transport endpoint, and capabilities. The schema is being standardized at https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2127

Skill: https://isitagentready.com/.well-known/agent-skills/mcp-server-card/SKILL.md

Docs: https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2127

サブスキル：mcp-server-card/SKILL.md

agentSkills

Goal: Publish an agent skills discovery index

Issue: {issue}

Fix: Publish a skills discovery index at /.well-known/agent-skills/index.json (per the Agent Skills Discovery RFC v0.2.0). Include a $schema field, and a skills array where each entry has name, type, description, url, and a sha256 digest.

Skill: https://isitagentready.com/.well-known/agent-skills/agent-skills/SKILL.md

Docs: https://github.com/cloudflare/agent-skills-discovery-rfc, https://agentskills.io/

サブスキル：agent-skills/SKILL.md

webMcp

Goal: Support WebMCP to expose site tools to AI agents via the browser

Issue: {issue}

Fix: Implement the WebMCP API by calling navigator.modelContext.provideContext() with tool definitions that expose your site's key actions to AI agents. Each tool needs a name, description, inputSchema (JSON Schema), and an execute callback function.

Skill: https://isitagentready.com/.well-known/agent-skills/webmcp/SKILL.md

Docs: https://webmachinelearning.github.io/webmcp/, https://developer.chrome.com/blog/webmcp-epp

サブスキル：webmcp/SKILL.md

ard

Goal: Publish an ARD capability manifest at /.well-known/ai-catalog.json

Issue: {issue}

Fix: Serve /.well-known/ai-catalog.json with Content-Type application/json, HTTP 200, and Access-Control-Allow-Origin: *. Include specVersion, a host object (displayName + identifier), and a non-empty entries array. Each entry needs identifier, displayName, type, exactly one of url or data, and 2-5 representativeQueries. Use urn:air:<fqdn>:<namespace>:<name> for entry identifiers.

Skill: https://isitagentready.com/.well-known/agent-skills/ard/SKILL.md

Docs: https://agenticresourcediscovery.org/, https://github.com/Agent-Card/ai-catalog

サブスキル：ard/SKILL.md

personalAgentProtocol

Goal: Publish Personal Agent Protocol (Poppy) discovery at /.well-known/poppy.json

Issue: {issue}

Fix: Publish the manifest and any required RFC 8414 metadata. Website-only declarations can use web: {} without auth. When agent protocols, APIs, or a browser session endpoint are declared, set auth.issuer and publish issuer metadata with a matching issuer, poppy_domains containing organization.domain, and HTTPS token_endpoint and revocation_endpoint. Informational: does not affect level or score.

Skill: https://isitagentready.com/.well-known/agent-skills/personal-agent-protocol/SKILL.md

Docs: https://personalagentprotocol.org/docs/spec#3-discovery

サブスキル：personal-agent-protocol/SKILL.md

x402

Goal: Support x402 protocol for agent-native HTTP payments

Issue: {issue}

Fix: Add x402 payment middleware to your API routes to enable AI agents to pay for access via HTTP. Use @x402/express, @x402/hono, or @x402/next middleware with a facilitator URL and wallet address. Protected routes will return HTTP 402 with payment requirements that agents can fulfill automatically.

Skill: https://isitagentready.com/.well-known/agent-skills/x402/SKILL.md

Docs: https://x402.org, https://github.com/coinbase/x402, https://docs.x402.org

サブスキル：x402/SKILL.md

ucp

Goal: Enable content payments via Universal Commerce Protocol

Issue: {issue}

Fix: Serve /.well-known/ucp with protocol version, services, capabilities, and endpoints, and ensure spec URLs and schemas are reachable.

Skill: https://isitagentready.com/.well-known/agent-skills/ucp/SKILL.md

Docs: https://ucp.dev/specification/overview/

サブスキル：ucp/SKILL.md

acp

Goal: Publish ACP discovery metadata so agents can discover your commerce API

Issue: {issue}

Fix: Serve /.well-known/acp.json at the origin root with protocol.name "acp", protocol.version, api_base_url, supported transports, and capabilities.services so agents can discover your ACP implementation without creating a checkout session first.

Skill: https://isitagentready.com/.well-known/agent-skills/acp/SKILL.md

Docs: https://agenticcommerce.dev, https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/pull/137

サブスキル：acp/SKILL.md

a2aAgentCard

Goal: Publish an A2A Agent Card for agent-to-agent discovery

Issue: {issue}

Fix: Serve JSON at /.well-known/agent-card.json with name, version, description, supportedInterfaces (service URL and transport), capabilities, and skills (each with id, name, description). See the A2A Protocol Specification for the full schema.

Skill: https://isitagentready.com/.well-known/agent-skills/a2a-agent-card/SKILL.md

Docs: https://a2a-protocol.org/latest/specification/, https://a2a-protocol.org/latest/topics/agent-discovery/

サブスキル：a2a-agent-card/SKILL.md

dnsAid

Goal: Publish DNS for AI Discovery (DNS-AID) records for DNS-based agent discovery

Issue: {issue}

Fix: Publish SVCB or HTTPS records under your domain's _agents namespace (e.g. _a2a._agents.example.com or _index._agents.example.com). Use alpn and port SvcParamKeys with mandatory=alpn,port. Use numeric keyNNNNN names for experimental custom parameters until registered. Sign zones with DNSSEC.

Skill: https://isitagentready.com/.well-known/agent-skills/dns-aid/SKILL.md

Docs: https://datatracker.ietf.org/doc/draft-mozleywilliams-dnsop-dnsaid/, https://www.rfc-editor.org/info/rfc9460

サブスキル：dns-aid/SKILL.md

authMd

Goal: Publish Auth.md agent registration discovery metadata

Issue: {issue}

Fix: Serve /auth.md from the site root as Markdown with an H1 heading containing "auth.md". Include OAuth Protected Resource Metadata at /.well-known/oauth-protected-resource and Authorization Server metadata. Add an agent_auth block with skill, register_uri, and registration methods. If OAuth is not available, keep /auth.md self-contained with audience, registration endpoints, and credential use.

Skill: https://isitagentready.com/.well-known/agent-skills/auth-md/SKILL.md

Docs: https://auth-md.com

サブスキル：auth-md/SKILL.md

mpp

Goal: Support MPP (Machine Payment Protocol) for agent-native HTTP payments

Issue: {issue}

Fix: Serve /openapi.json at the site root with HTTP 200. Include x-payment-info extensions on payable operations declaring intent (charge or session), method (tempo, stripe, lightning, card), and amount. Optionally include currency, description, and top-level x-service-info with categories.

Skill: https://isitagentready.com/.well-known/agent-skills/mpp/SKILL.md

Docs: https://mpp.dev, https://paymentauth.org/draft-payment-discovery-00.txt

サブスキル：mpp/SKILL.md

llmsTxt

Goal: Publish an LLM-friendly overview at /llms.txt

Issue: {issue}

Fix: Serve /llms.txt as plain text (UTF-8) with HTTP 200. Start with an H1 title line, include a short summary paragraph, and link to the most important content sections for agents. Optionally link to /llms-full.txt for expanded content.

Skill: https://isitagentready.com/.well-known/agent-skills/llms-txt/SKILL.md

Docs: https://llmstxt.org/

サブスキル：llms-txt/SKILL.md

llmsFullTxt

Goal: Publish expanded LLM content at /llms-full.txt

Issue: {issue}

Fix: Serve /llms-full.txt as plain text (UTF-8) with HTTP 200. Include structured, detailed content suitable for LLM ingestion covering key topics, APIs, and documentation. Link to it from your /llms.txt file.

Skill: https://isitagentready.com/.well-known/agent-skills/llms-full-txt/SKILL.md

Docs: https://llmstxt.org/

サブスキル：llms-full-txt/SKILL.md

ap2

Goal: Declare AP2 support in your A2A Agent Card for agent payments

Issue: {issue}

Fix: Add AP2 extension to your A2A Agent Card at /.well-known/agent-card.json with your role (merchant, shopper, etc.) so agents can discover your payment capabilities.

Docs: https://ap2-protocol.org/