agent-ready-a2a-agent-card — скилл для Claude Code: обзор и запуск
Скилл agent-ready-a2a-agent-card для Claude Code настраивает карточку агента по протоколу A2A и публикует /.well-known/agent-card.json. Это позволяет другим агентам обнаруживать сервис.
Apache-2.0 ★ 141 обновлён 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a claude-codeЧто делает agent-ready-a2a-agent-card
Скилл инструктирует агента настроить эндпоинт /.well-known/agent-card.json с кодом ответа HTTP 200. В манифесте описывается схема с полями name, version, description, сетевыми адресами в supportedInterfaces, а также списками capabilities и skills.
Инструкции опираются на спецификацию A2A Protocol Specification. В них учтена интеграция с Cloudflare Agents SDK на платформе Cloudflare Workers. Без точного пути /.well-known/agent-card.json внешние клиенты не смогут обнаружить агента автоматически.
Для проверки корректности манифеста скилл предлагает отправить POST-запрос на https://isitagentready.com/api/scan. Настройка считается завершённой, когда поле checks.discovery.a2aAgentCard.status возвращает значение pass.
Какие задачи решает
- опубликовать манифест
agent-card.jsonпо спецификации A2A - настроить обнаружение агента для Cloudflare Workers
- проверить карточку агента через сканер
https://isitagentready.com/api/scan
Примеры запросов агенту
- Сделай маршрут
/.well-known/agent-card.jsonдля нашего воркера - Заполни карточку A2A с описанием интерфейсов и навыков
- Проверь готовность карточки агента через валидационный API
Как установить agent-ready-a2a-agent-card
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a claude-code2Вручную: положить файлы
~/.claude/skills/a2a-agent-card/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/a2a-agent-card/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a codex2Вручную: положить файлы
.agents/skills/a2a-agent-card/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a cursor2Вручную: положить файлы
.cursor/skills/a2a-agent-card/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/a2a-agent-card2Вручную: положить файлы
.github/skills/a2a-agent-card/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-a2a-agent-card -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/a2a-agent-cardВручную: положить файлы
.devin/skills/a2a-agent-card/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об agent-ready-a2a-agent-card
Как установить agent-ready-a2a-agent-card в Claude Code?
Выполните команду npx skills add fabricioctelles/skills --skill a2a-agent-card -a claude-code. Файл скилла будет сохранён в ~/.claude/skills/a2a-agent-card/SKILL.md.
Что делает agent-ready-a2a-agent-card?
Скилл передаёт требования к схеме A2A Agent Card. Он помогает агенту сформировать правильный JSON-файл обнаружения и валидировать его через сканер.
Какие поля обязательны для манифеста карточки?
Требуются параметры name, version, description и блок supportedInterfaces с протоколом и URL. В списках capabilities и skills для каждого элемента задаются id, name и description.
Исходный текст
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