Agent Skills Discovery RFC
Cloudflare's draft for publishing Agent Skills at /.well-known/agent-skills/, with an index.json listing each skill and a SHA-256 digest.
Tags
Description
Draft v0.2.0 (published 2026-01-17, updated 2026-03-12). v0.2.0 renamed the path from /.well-known/skills/ to /.well-known/agent-skills/, identifies the index schema by $schema (https://schemas.agentskills.io/discovery/0.2.0/schema.json), and gives each entry a type (skill-md or archive), url and digest. Clients load names and descriptions first and fetch skills on demand; they SHALL NOT execute bundled scripts by default. Not backward-compatible with v0.1.0. Apache-2.0. The RFC calls $schema an opaque identifier: clients match it against known URIs and it need not resolve (schemas.agentskills.io failed TLS on 2026-11-04).
Related
- Agent Skills Specification: Open format for packaging agent capabilities as folders with a SKILL.md (YAML frontmatter + instructions) plus optional scripts and resources.
- AI Catalog: Draft JSON format, served at /.well-known/ai-catalog.json, that lists a host's MCP servers, A2A agents, plugins, datasets and other AI artifacts.
- Cloudflare Skills: Cloudflare's official Agent Skills and plugin for building on Workers, the Agents SDK, Durable Objects, Sandbox, Wrangler and the wider Developer Platform; bundles the Cloudflare MCP server.
- skills.sh: The open Agent Skills directory: browse skills ranked by installs and install them into your agent with one command.
Guides & comparisons
- Make your site and API discoverable by agents (Guide): Publish the files agents look for: an RFC 9727 API catalog, an AI Catalog, an MCP Server Card, an Agent Skills index and llms.txt. Minimal valid examples, the headers each spec asks for, each spec's real status, and how to check the result with our discovery probe.
Sources
Machine-readable
- JSON
- Markdown
- Source file on GitHub (edit via pull request)