Omni Agents A2a
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.
Get the complete skill folder, including its scripts and reference files.
When to use this skill
Use Omni Agents A2a when an AI agent needs a reusable SKILL.md workflow for this job: 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.
When not to use it
Skip Omni Agents A2a when the task is outside the coding category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.
How to install
Where will you use it?
mkdir -p ~/.claude/skills/omni-agents-a2a # Save SKILL.md to ~/.claude/skills/omni-agents-a2a/SKILL.md
- Claude Code personal install: place the skill and its bundled files at ~/.claude/skills/omni-agents-a2a/SKILL.md. For a shared project, commit the folder at .claude/skills/omni-agents-a2a/ instead.
- Current Claude Code detects SKILL.md changes in watched directories during the session. If you just created a top-level skills directory, run /reload-skills. Check that the skill is listed before testing its trigger.
- For Claude chat or Cowork in the Desktop app, manage uploaded skills in Customize > Skills; copying files into a local Claude Code folder is not a Desktop install. Other agents may use different install locations.
Full install guide for Claude, Cursor, and Codex →
Try a starter prompt
After installing the skill, paste this starter prompt into your agent to verify it triggers on a small task.
Use the Omni Agents A2a skill for this task: Use Omni Agents A2a when this documented workflow matches the task. Confirm any required inputs or files before making changes.
What supports this recommendation?
71/100 provisional content score. This measures documentation, practical detail and source signals. It is not a measured task success rate or a security certification.
- Documentation
- 77/100
- Practical detail
- 68/100
- Source evidence
- 63/100
- Source signals
- 72/100
Model compatibility evidence
- claudeuntested
No model-specific signal or recorded compatibility test was found.
- chatgptuntested
No model-specific signal or recorded compatibility test was found.
- geminiuntested
No model-specific signal or recorded compatibility test was found.
- copilotuntested
No model-specific signal or recorded compatibility test was found.
- llamauntested
No model-specific signal or recorded compatibility test was found.
- perplexityuntested
No model-specific signal or recorded compatibility test was found.
- mistraluntested
No model-specific signal or recorded compatibility test was found.
- grokuntested
No model-specific signal or recorded compatibility test was found.
Inferred compatibility is based on content signals. Check the app, its available tools and setup requirements before running a skill.
What this skill does
<!-- 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/cheaper-inference/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) | | `list-capabilities` | Returns the full catalog of OmniRoute agent skills |
## 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/cheaper-inference/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md <!-- skill:custom-end -->
Intended uses
- Use Omni Agents A2a when this documented workflow matches the task.
Implementation notes
- Review the source instructions and adapt inputs before running the workflow.
Try it, then tell us how it went
A copied prompt does not tell us whether the task worked. Report your result after checking the output. We collect your tool and outcome, never your files or prompt.