Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

omni-agents-a2a — Claude Code skill: agent-to-agent routing

Skill for agent-to-agent interaction via JSON-RPC 2.0 protocol. Agents discover each other, pick optimal models by cost and capabilities, check quotas, and monitor system health.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add cheaper-inference/OmniRoute --skill omni-agents-a2a -a claude-code
Open on GitHub

What omni-agents-a2a does

omni-agents-a2a exposes 6 built-in skills to talk with OmniRoute: smart-routing picks the best provider/model pair for a task, quota-management reports remaining quota, provider-discovery filters providers by features (vision, JSON mode, tools, max context), cost-analysis estimates request cost, health-report returns system status including circuit states and latencies.

All requests go to the /a2a endpoint over JSON-RPC 2.0 with a Bearer token. The agent publishes an Agent Card at /.well-known/agent.json listing available skills and auth schemes. Requires OMNIROUTE_URL and OMNIROUTE_KEY environment variables.

Errors follow JSON-RPC codes: -32600 for invalid request, -32601 for method not found, -32602 for invalid params, 401 for auth failure. Full OpenAPI schema is available at GET /api/openapi/spec or in docs/openapi.yaml.

What it helps with

  • pick a provider and model based on task cost and feature needs
  • check quota balance before sending a large request
  • get a list of providers supporting vision, JSON mode, and tools
  • estimate request cost before execution
  • monitor system health: latencies, errors, circuit breaker states

Example prompts for the agent

  • Recommend the best provider and model for a 4000-token prompt that needs tools
  • Show remaining quota for my current account and provider
  • Find all providers that support vision and JSON mode

How to install omni-agents-a2a

1Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill omni-agents-a2a -a claude-code

2Manually: put the files in place

~/.claude/skills/omni-agents-a2a/SKILL.md

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

From the same set34

The whole set →
cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. Claude Code CX Codex Cursor +1 1,200installs omni-combos-routing cheaper-inference This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing. Claude Code CX Codex Cursor +1 1,200installs omni-inference cheaper-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints. Claude Code CX Codex Cursor +1 1,100installs cli-providers cheaper-inference Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow. Claude Code CX Codex Cursor +1 1,100installs omni-auth cheaper-inference Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access. Claude Code CX Codex Cursor +1 1,100installs cli-routing cheaper-inference Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively. Claude Code CX Codex Cursor +1 1,100installs omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs omni-providers cheaper-inference Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models. Claude Code CX Codex Cursor +1 1,100installs

Similar

prompt-engineer https://github.com/Jeffallan A skill that writes, refactors and tests LLM prompts: templates, JSON schemas, scoring rubrics, test suites. Useful when model output is inconsistent and you need to know why. Claude Code CX Codex Cursor +1 5,600installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. Claude Code CX Codex Cursor +1 410,700installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. Claude Code CX Codex Cursor +1 410,300installs shadcn shadcn-ui A skill that keeps your agent on the rails with shadcn/ui: adds components, searches registries, fixes markup and builds a design system from your spec. Claude Code CX Codex Cursor +1 122,100installs

Questions about omni-agents-a2a

How do I install omni-agents-a2a in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill omni-agents-a2a -a claude-code. The skill will be installed to ~/.claude/skills/omni-agents-a2a/SKILL.md.

What do I need to use omni-agents-a2a?

Set OMNIROUTE_URL (server address) and OMNIROUTE_KEY (Bearer token) environment variables. Get a token via POST /api/auth/login or set REQUIRE_API_KEY=false for local development.

Which skills does omni-agents-a2a provide?

smart-routing selects the optimal model, quota-management shows remaining quota, provider-discovery filters providers, cost-analysis calculates cost, health-report checks system status.

Source text

SKILL.md · MIT 
---
name: omni-agents-a2a
description: "Interact with OmniRoute via JSON-RPC 2.0 agent-to-agent protocol. 6 built-in A2A skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report, list-capabilities."
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Interact with OmniRoute via JSON-RPC 2.0 agent-to-agent protocol. 6 built-in A2A skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report, list-capabilities.

## Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.

## Endpoints

_No endpoints mapped for this area yet._
## Payloads

See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.

<!-- skill:custom-start -->
<!-- Migrated from skills/omniroute-a2a/SKILL.md (preserved curated content) -->

# OmniRoute — A2A Protocol

Requires `OMNIROUTE_URL` and `OMNIROUTE_KEY`. See [entry-point SKILL](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omni-auth/SKILL.md) for setup.

OmniRoute publishes an Agent Card at `/.well-known/agent.json` and accepts
JSON-RPC 2.0 calls at `/a2a`.

## Discovery

```bash
curl $OMNIROUTE_URL/.well-known/agent.json
```

Returns Agent Card with skills, endpoints, auth scheme.

## Available skills

| Skill                | Purpose                                                                             |
| -------------------- | ----------------------------------------------------------------------------------- |
| `smart-routing`      | Given a prompt, recommends best provider/model combo                                |
| `quota-management`   | Reports quota balance for given provider/account                                    |
| `provider-discovery` | Lists providers matching capability filters (vision, JSON mode, tools, max-context) |
| `cost-analysis`      | Estimates cost for a given request shape                                            |
| `health-report`      | Returns system health (circuit states, latencies, errors)                           |

## Call example (JSON-RPC 2.0)

```bash
curl -X POST $OMNIROUTE_URL/a2a \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tasks/send",
    "params": {
      "skillId": "smart-routing",
      "input": { "prompt_length": 4000, "tools": true, "vision": false }
    },
    "id": 1
  }'
```

## Response shape

```json
{
  "jsonrpc": "2.0",
  "result": {
    "taskId": "...",
    "status": "completed",
    "output": { "recommended_combo": "...", "reasoning": "..." }
  },
  "id": 1
}
```

## Errors

- `-32600` → invalid request (bad JSON-RPC envelope)
- `-32601` → method not found (check `method` field)
- `-32602` → invalid params (check `skillId` against Agent Card)
- `401` → missing/invalid `OMNIROUTE_KEY`

## Reference

Full docs: https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md
<!-- skill:custom-end -->

© cheaper-inference · MIT · cheaper-inference/OmniRoute

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor