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.