CONCEPT Cited by 1 source

Agent Skills discovery¶

Definition¶

Agent Skills discovery is the pattern of publishing a well-known JSON index at /.well-known/agent-skills/index.json that lists skill documents an agent can ingest to learn how to perform specific tasks against the site.

Draft standard originated by Cloudflare; authored at cloudflare/agent-skills-discovery-rfc. Related community namespace at agentskills.io.

What a skill document is¶

A skill document is task-instructional prose — richer than a tool schema (which says "here's the scan_site signature"), intended to teach an agent "here's how to do the thing: prerequisites, step sequence, common pitfalls, examples."

Complementary to:

MCP tool schemas — what's callable + how (signatures).
concepts/mcp-server-card — which MCP server + which tools exist (discovery + metadata).
concepts/api-catalog — classical API specs (OpenAPI, etc.) for HTTP-era integration.
Agent skills — tutorial / playbook-shaped guidance at the task level.

Why discovery lives at `/.well-known/`¶

One more member of the cluster of agent-ergonomics standards sharing the /.well-known/ prefix defined by RFC 8615. The cluster now includes:

robots.txt (not under /.well-known/ for historical reasons, but functionally equivalent).
/.well-known/api-catalog (API Catalog, RFC 9727).
/.well-known/mcp/server-card.json (MCP Server Card).
/.well-known/agent-skills/index.json (this concept).
/.well-known/http-message-signatures-directory (Web Bot Auth).
/.well-known/oauth-protected-resource (RFC 9728).

Captured as patterns/well-known-endpoint-discovery.

Self-referential canonical instance¶

isitagentready.com publishes its own Agent Skills index at https://isitagentready.com/.well-known/agent-skills/index.json with one skill document per standard it checks — so agents inspecting its own output "not only know what to fix, but how to fix it." Cloudflare's developer docs similarly add an "LLM Resources" sidebar entry linking to llms.txt, llms-full.txt, and Cloudflare Skills.

Adoption (2026-04)¶

Very early. isitagentready is the reference-implementation instance; most of the ecosystem is still converging on the skill-document shape.

Seen in¶

sources/2026-04-17-cloudflare-introducing-the-agent-readiness-score-is-your-site-agent-ready — canonical wiki instance. Cloudflare checks this under the Agent Readiness Score's Agent Actions dimension.

systems/agent-skills — wiki system page.
concepts/well-known-uri — substrate convention.
concepts/agent-readiness-score — where this is graded.
concepts/mcp-server-card / concepts/api-catalog — sibling discovery primitives at adjacent abstraction levels.
patterns/well-known-endpoint-discovery — umbrella.