How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/diegosouzapw/omniroute --skill omni-agents-a2aBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
<!-- 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 for setup.
OmniRoute publishes an Agent Card at /.well-known/agent.json and accepts JSON-RPC 2.0 calls at /a2a.
Discovery
curl $OMNIROUTE_URL/.well-known/agent.jsonReturns 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)
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
{
"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 (checkmethodfield)-32602→ invalid params (checkskillIdagainst Agent Card)401→ missing/invalidOMNIROUTE_KEY
Reference
Full docs: https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md <!-- skill:custom-end -->
