agent-ready-a2a-agent-card

Implement an A2A Agent Card served at /.well-known/agent-card.json for Cloudflare Workers agents.

47|4|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/fabricioctelles/skills --skill agent-ready-a2a-agent-card
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-ready-a2a-agent-card
Source: https://github.com/fabricioctelles/skills/tree/main/skills/agent-ready-cloudflare/a2a-agent-card
Command: npx skills add https://github.com/fabricioctelles/skills --skill agent-ready-a2a-agent-card

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps agents publish a standardized A2A Agent Card so other agents and discovery tools can identify their capabilities, interfaces, and available skills.

Core Features & Use Cases

  • Agent Card Implementation: Define the required name, version, description, supported interfaces, transport protocol, capabilities, and skills.
  • Well-Known Endpoint: Serve the Agent Card as JSON from the standard discovery endpoint with an HTTP 200 response.
  • Cloudflare Integration: Apply the A2A discovery pattern to agents built with the Cloudflare Agents SDK.
  • Validation: Submit the deployed agent URL to the readiness scanner and verify that the A2A Agent Card check passes.

Quick Start

Use the agent-ready-a2a-agent-card skill to implement and validate an A2A Agent Card for your deployed agent.

Frequently Asked Questions about agent-ready-a2a-agent-card

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is an A2A agent card and how does agent discovery work?▼

An A2A agent card is a standardized JSON file served at the /.well-known/agent-card.json endpoint that enables agent discovery. It allows other agents and compatible clients to identify your agent's capabilities, supported interfaces, and available skills.

How do I make my Cloudflare Workers agent discoverable by other agents?▼

To make your Cloudflare Workers agent discoverable, implement an A2A agent card by serving valid JSON at /.well-known/agent-card.json. This file must define your agent's name, version, transport protocol, capabilities, and skills for other agents to find.

What metadata is required in a /.well-known/agent-card.json file?▼

A valid /.well-known/agent-card.json file requires specific metadata including the agent's name, version, description, supported interfaces, transport protocol, capabilities, and skill definitions. This standardized metadata ensures compatibility and proper agent-to-agent discovery.

Can I use the A2A discovery pattern with agents built outside the Cloudflare Agents SDK?▼

Yes, while the A2A discovery pattern applies to agents built with the Cloudflare Agents SDK, it also extends to other services. Any service needing standardized agent-to-agent discovery can serve the required JSON agent card from the well-known endpoint.

How do I validate that my A2A agent card is ready for agent-to-agent discovery?▼

You validate your A2A agent card by submitting the deployed agent URL to the readiness scanner. This validation checks if the /.well-known/agent-card.json endpoint returns an HTTP 200 response and if the A2A agent card configuration passes the readiness check.