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
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a claude-codeWhat 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.jsonroute 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-code2Manually: put the files in place
~/.claude/skills/a2a-agent-card/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/a2a-agent-card/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a codex2Manually: put the files in place
.agents/skills/a2a-agent-card/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a cursor2Manually: put the files in place
.cursor/skills/a2a-agent-card/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/a2a-agent-card2Manually: put the files in place
.github/skills/a2a-agent-card/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/a2a-agent-cardManually: put the files in place
.devin/skills/a2a-agent-card/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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