Skip to main content
skill CX Codex

agent-ready-a2a-agent-card — Claude Code skill: setup guide

agent-ready-a2a-agent-card generates an A2A Agent Card file for agent-to-agent discovery. Useful when setting up agent endpoints on Cloudflare Workers.

Apache-2.0 ★ 141 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a claude-code
Open on GitHub

What agent-ready-a2a-agent-card does

This skill guides the assistant in serving a valid /.well-known/agent-card.json file returning HTTP 200. The payload follows the A2A Protocol Specification, describing agent interfaces, capabilities, and individual skills.

The workflow accounts for Cloudflare Agents SDK running on Workers. Missing the exact /.well-known/agent-card.json endpoint path breaks automated discovery immediately.

To verify compliance, the skill provides a POST test targeting https://isitagentready.com/api/scan. The check is successful when checks.discovery.a2aAgentCard.status returns "pass".

What it helps with

  • publish an A2A Agent Card JSON endpoint
  • define interfaces and skills for Cloudflare Workers agents
  • run validation checks using https://isitagentready.com/api/scan

Example prompts for the agent

  • Create the /.well-known/agent-card.json route for this worker
  • Fill out the A2A agent card capabilities and transport details
  • Test our agent card against the validation API

How to install agent-ready-a2a-agent-card

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a claude-code

2Manually: put the files in place

~/.claude/skills/a2a-agent-card/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/a2a-agent-card/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-ready-a2a-agent-card

How to install agent-ready-a2a-agent-card in Claude Code?

Run npx skills add fabricioctelles/skills --skill a2a-agent-card -a claude-code. The instructions install to ~/.claude/skills/a2a-agent-card/SKILL.md.

What does agent-ready-a2a-agent-card do?

It provides the specification and fields needed to publish an agent discovery card. It also includes instructions for validating the live endpoint.

How do you validate the published agent card?

Send a POST request with your site URL to https://isitagentready.com/api/scan. Look for checks.discovery.a2aAgentCard.status returning "pass".

Source text

SKILL.md · Apache-2.0
---
name: agent-ready-a2a-agent-card
description: >
  Sub-skill de agent-ready-cloudflare: Implement A2A Agent Card
---
# Implement A2A Agent Card

Publish an A2A Agent Card for agent-to-agent discovery per the
[A2A Protocol Specification](https://a2a-protocol.org/latest/specification/).

## Requirements

- Serve JSON at `/.well-known/agent-card.json` with HTTP 200
- Include `name`, `version`, and `description`
- Include `supportedInterfaces` with service URL and transport protocol
- List `capabilities` and `skills` (each with `id`, `name`, `description`)

See [Agent Discovery](https://a2a-protocol.org/latest/topics/agent-discovery/)
for the full schema.

## Cloudflare

[Agents SDK](https://developers.cloudflare.com/agents/) supports building
A2A-compatible agents on Workers.

## Validate

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}
```

Check that `checks.discovery.a2aAgentCard.status` is `"pass"`.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set46

The whole set →
agent-ready-robots-txt The agent-ready-robots-txt skill publishes a standards-compliant robots.txt at your site root per RFC 9309. Use it when agents need to control bot access and reference your sitemap. CX Codex +1 ★ 141repo stars agent-ready-api-catalog agent-ready-api-catalog implements an RFC 9727 API catalog so autonomous agents can discover your endpoints and OpenAPI specifications. CX Codex +1 ★ 141repo stars agent-ready-content-signals The agent-ready-content-signals skill adds Content Signals to robots.txt, letting you set preferences for AI training, search, and AI input. CX Codex +1 ★ 141repo stars agent-ready-mcp-server-card agent-ready-mcp-server-card — a skill that publishes an MCP Server Card, a JSON file for agent discovery. Use it when running your own MCP server and want tools like isitagentready.com to find and validate it. CX Codex +1 ★ 141repo stars agent-ready-web-bot-auth The agent-ready-web-bot-auth skill guides Web Bot Auth setup so receiving sites can verify bot or agent requests. Use it when your site needs to identify its signed outbound traffic. CX Codex +1 ★ 141repo stars agent-ready-agent-skills agent-ready-agent-skills publishes an agent skills discovery index matching the RFC v0.2.0 specification. Useful when exposing local agent tools to external crawlers. CX Codex +1 ★ 141repo stars agent-ready-oauth-protected-resource agent-ready-oauth-protected-resource publishes OAuth Protected Resource Metadata so agents can discover how to authenticate. It fits Cloudflare setups that expose a protected resource. CX Codex +1 ★ 141repo stars agent-ready-link-headers agent-ready-link-headers is a Claude Code skill that adds Link response headers to a site's homepage so AI agents can discover its API and documentation automatically. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open