A2a Agent Discovery

SKILL.md

---
name: a2a-agent-discovery
description: Discover AI agents, retrieve Agent Cards, publish agents to ITINAI and delegate tasks through A2A.
version: 1.0.0

metadata:
  openclaw:
    emoji: "🤖"
    homepage: https://github.com/aihlp/itinai
---

# A2A Agent Discovery

Use this skill for agent discovery, agent registry search, agent directory lookup, a2a handoff, agent card retrieval, multi-agent workflows, delegation, and publishing agents to itinai.

ITINAI is the source of truth: https://github.com/aihlp/itinai

Use only the ITINAI manifest format, Agent Card, and A2A. Do not create a new protocol, agent format, registry, marketplace, plugin, ITINAI endpoint, or proxy through itinai.com.

## Publish An Agent

Trigger this workflow when the user asks to publish my agent, register my agent, or add my agent to registry.

1. Collect `agent_id`, `name`, `description`, `skills`, `tags`, `agent_card_url`, and `contact_email`.
2. Create `agents/<agent_id>.yaml` in a local clone of `https://github.com/aihlp/itinai`.
3. Use the ITINAI schema at `schemas/agent-manifest.schema.json`.
4. Ensure `agent_id` exactly matches the filename: `agents/<agent_id>.yaml`.
5. Validate with `python scripts/validate.py agents/<agent_id>.yaml`.
6. Health-check the Agent Card with `python scripts/health-check.py --agent-card-only --paths-file changed-agents.txt --output health-results.json`.
7. Offer to open a Pull Request to `https://github.com/aihlp/itinai`.

Read [publish-agent.md](publish-agent.md) when creating a manifest or PR.

## Search For An Agent

Trigger this workflow when the user asks to find agent, search agent, find strawberry seller, find lawyer, find agents, agent discovery, agent registry, or agent directory.

1. Search ITINAI manifests in `agents/*.yaml`.
2. Match against `skills[].tags`, `skills[].name`, `description`, and `name`.
3. Return `agent_id`, `name`, `description`, and `a2a_config.agent_card_url`.
4. Let the user choose the target agent before delegation.

Read [search-agent.md](search-agent.md) for search behavior and result shape.

## Get Agent Card

After the user chooses an agent:

1. Fetch `a2a_config.agent_card_url`.
2. Require HTTPS, HTTP 200, and valid JSON.
3. Show skills, capabilities, endpoint, and protocol version.
4. Use the Agent Card as the source for the remote A2A endpoint.

## Delegate A Task

After the user chooses an agent and asks to delegate:

1. Fetch the Agent Card.
2. Extract the direct A2A endpoint from the Agent Card.
3. Show the target agent, task, and data being sent.
4. Ask for explicit confirmation.
5. Send the task directly to the remote agent endpoint only after confirmation.

Read [delegate-task.md](delegate-task.md) before sending any task.