SYSTEM Cited by 3 sources

Agent Skills (standard)

Overview

Agent Skills is an emerging standard for publishing task-instructional documents (skill documents) at a fixed well-known URL so AI agents can discover what specialised tasks a site's ecosystem can help perform.

Cloudflare's proposed discovery mechanism: an index JSON document at /.well-known/agent-skills/index.json listing each skill document and its URL — see concepts/agent-skills-discovery for the discovery concept.

Shape

• Index file at the well-known URL listing skills.
• Skill documents — prose / structured markdown / JSON describing how to perform a specific task against the site. Richer than a tool schema (which says "call this function with these args"); more like a playbook ("here's the sequence, the prerequisites, the common pitfalls, an example").

The draft spec lives at cloudflare/agent-skills-discovery-rfc. Community site at agentskills.io.

Complementary to MCP tool schemas

• MCP tool schemas — function signatures, machine-callable.
• MCP Server Cards — pre-connect description of an MCP server.
• Agent Skills — task-level how-to prose the agent reads and reasons over.

The three address different altitudes of agent-action guidance: callable surface (MCP tools), server metadata (MCP Server Card), task playbook (Agent Skill).

Self-referential reference implementation

isitagentready.com publishes its Agent Skills index at https://isitagentready.com/.well-known/agent-skills/index.json — one skill document per standard it checks. An agent that scans a site with isitagentready and gets a failing robots.txt check can fetch the relevant skill document and apply the remediation without human-written prompt engineering.

As a framework-migration delivery surface (2026-02-24)

The 2026-02-24 vinext launch adds a second consumption pattern for Agent Skills: shipping framework migrations as Agent Skills. cloudflare/vinext is the canonical wiki instance — npx skills add cloudflare/vinext, then "migrate this project to vinext" in Claude Code, OpenCode, Cursor, Codex CLI, or any other supported tool. The skill handles compat checks, dependency install, config generation, and dev-server startup. Agent Skills gain cross-tool migration tooling as a use case alongside the well-known-URL self-description use case.

Status (2026-04)

Draft standard. Cloudflare is authoring the RFC and dogfooding it simultaneously (isitagentready scans the site's /.well-known/agent-skills/index.json and grades its presence under the Agent Readiness Score's Agent Actions dimension). Wider uptake expected as the spec matures and MCP-client implementations grow discovery support for it.

Seen in

• sources/2026-04-17-cloudflare-introducing-the-agent-readiness-score-is-your-site-agent-ready — canonical wiki instance. isitagentready.com's own Agent Skills index is the reference implementation.
• sources/2026-04-01-cloudflare-emdash-wordpress-spiritual-successor — Agent Skills shipped inside a product for the first time on this wiki: every EmDash instance includes Agent Skills describing plugin capabilities, triggering hooks, a plugin-authoring skill, and a WordPress-theme-to-EmDash porting skill. Agents pointed at an EmDash codebase find the skills and work from them. Extends Agent Skills from "a well-known-URL-on-your-site discovery surface" (2026-04-17 canonical instance) to "a shipped-in-the-product integration-guidance surface" — two distinct deployment shapes of the same primitive.

Related

• concepts/agent-skills-discovery — concept page.
• concepts/well-known-uri — substrate.
• concepts/mcp-server-card / systems/model-context-protocol — sibling discovery surfaces.
• concepts/agent-readiness-score — where this is graded.
• systems/isitagentready — reference-implementation publisher.
• systems/emdash — product shipping Agent Skills in-tree as plugin-authoring / theme-porting guidance.
• patterns/well-known-endpoint-discovery — umbrella pattern.