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.
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.
Sources
Machine-readable
- JSON
- Markdown
- Source file on GitHub (edit via pull request)