Skip to content

AGENT-SKILLS.md

Latest commit

 

History

History
317 lines (235 loc) · 16.8 KB

AGENT-SKILLS.md

File metadata and controls

317 lines (235 loc) · 16.8 KB
Raw

OmniRoute Agent Skills Catalog (Igbo)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

Ebe eziokwu sitere: src/lib/agentSkills/ (katalọgụ, jenereịta, ndị nyocha) + ndekọ skills/ (faịlụ SKILL.md) Emelitere ikpeazụ: 2026-08-02 — v3.8.50

Agent Skills bụ faịlụ SKILL.md ahaziri nke na-akụziri ndị nnọchiteanya mpụga, ndị ahịa MCP, na ndị nhazi A2A otu esi eji REST API na CLI nke OmniRoute. N'adịghị ka Omni Skills (nke bụ nkọwa ngwá ọrụ LLM a na-eme n'ime OmniRoute), Agent Skills bụ katalọgụ akwụkwọ nkọwa — markdown anaghị agbanwe agbanwe nke enwere ike itinye ozugbo n'ime ọnọdụ onye nnọchiteanya.

Nchịkọta

Katalọgụ ahụ nwere Agent Skills 45 (REST API 23 + CLI 21 + usoro nhazi 1). Nkà ọ bụla nwere:

  • ID iwu kwadoro (omni-auth, cli-serve, wdg.)
  • Faịlụ SKILL.md dị na skills/{id}/SKILL.md nwere YAML frontmatter (name, description) + ọdịnaya markdown zuru ezu
  • REST endpoints (nkà API) ma ọ bụ CLI subcommands (nkà CLI) ndị sitere na nkọwa OpenAPI na ndekọ CLI
  • URL raw GitHub maka iweta ya ozugbo: https://raw.githubusercontent.com/diegosouzapw/OmniRoute/refs/heads/main/skills/{id}/SKILL.md

Nhazi ụlọ ọrụ

src/shared/constants/agentSkills.ts    — Ndepụta ahọpụtara nwere ndenye 45 (aha/nkọwa/otu/mpaghara/akara)
src/lib/agentSkills/
  catalog.ts                           — getCatalog(), getSkillById(), filterCatalog(), computeCoverage()
  generator.ts                         — generateAgentSkills() na-ede SKILL.md na skills/{id}/
  openapiParser.ts                     — na-ewepụta REST endpoints site na docs/openapi.yaml
  cliRegistryParser.ts                 — na-ewepụta CLI subcommands site na bin/cli-registry.ts
  schemas.ts                           — Atụmatụ Zod: AgentSkillSchema, SkillCoverageSchema, wdg.
  types.ts                             — TypeScript interfaces: AgentSkill, SkillCoverage, wdg.

skills/{id}/SKILL.md                   — Faịlụ markdown emepụtara + ahọpụtara (45 n'ozuzu)

src/app/api/agent-skills/
  route.ts                             — GET /api/agent-skills
  [id]/route.ts                        — GET /api/agent-skills/{id}
  [id]/raw/route.ts                    — GET /api/agent-skills/{id}/raw (text/markdown)
  coverage/route.ts                    — GET /api/agent-skills/coverage
  generate/route.ts                    — POST /api/agent-skills/generate (achọrọ nkwenye njirimara)

open-sse/mcp-server/tools/agentSkillTools.ts  — Ngwá ọrụ MCP 3 (ndepụta, nweta, mkpuchi)
src/lib/a2a/skills/listCapabilities.ts        — Nkà A2A: list-capabilities

Ọdịdị SKILL.md

---
name: omni-providers
description: "Jikwaa njikọ ndị na-eweta ọrụ: tinye, nwalee, gbanwee, ma wepụ ozi nzuzo."
---

<!-- src/lib/agentSkills/generator.ts mepụtara ya; a ga-edegharị mmezi ejiri aka mee -->

## Nchịkọta

...

## Nkwenye njirimara

...

## Ebe njedebe

...

<!-- skill:custom-start -->

## Ngalaba Ahaziri Ahazi (a na-echekwa ya mgbe a na-emepụta ya ọzọ)

...

<!-- skill:custom-end -->

Jenereịta ahụ na-echekwa ọdịnaya dị n'etiti <!-- skill:custom-start --> na <!-- skill:custom-end --> mgbe a na-emepụta ya ọzọ. Nkà iri nwere blọk ahọpụtara ahazi:

omni-mcp, omni-compression, cli-providers, cli-eval, omni-agents-a2a, omni-combos-routing, omni-auth, omni-resilience, omni-inference, cli-serve.

Nchọpụta REST API

Endpoint Method Nkọwa Nnyenye ikike
/api/agent-skills GET Depụta katalọgụ (?category=api|cli|config&area=<area> bụ nke nhọrọ) enweghị
/api/agent-skills/{id} GET Nweta metadata nke otu nka enweghị
/api/agent-skills/{id}/raw GET Weta SKILL.md dịka text/markdown enweghị
/api/agent-skills/coverage GET Ndekọ mkpuchi (faịlụ SKILL.md ole dị) enweghị
/api/agent-skills/generate POST Kpalite generator (dryRun/prune/onlyIds) njikwa

Ọmụmaatụ — depụta nka API niile:

curl "http://localhost:20128/api/agent-skills?category=api"

Ọmụmaatụ — weta otu SKILL.md:

curl -H "Accept: text/markdown" "http://localhost:20128/api/agent-skills/omni-providers/raw"

Nchọpụta MCP

Edebanyere ngwá ọrụ MCP atọ n'okpuru scope read:catalog:

Ngwá ọrụ Nkọwa
omniroute_agent_skills_list Depụta nka (nzacha category / area bụ nke nhọrọ)
omniroute_agent_skills_get Nweta metadata + SKILL.md maka otu nka site na id
omniroute_agent_skills_coverage Ndekọ mkpuchi (API/CLI nwere/ngụkọta)

Lee MCP-SERVER.md maka njikọ scope na nnyenye ikike.

Nchọpụta A2A

Nka A2A list-capabilities na-eweghachi katalọgụ nka 45 zuru ezu dịka arịa tebụl markdown. Ndị nhazi mpụga nwere ike ịkpọ ya site na:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "skill": "list-capabilities",
    "messages": [{ "role": "user", "content": "List all capabilities" }]
  }
}

Lee A2A-SERVER.md maka nkọwa protocol.

Katalọgụ — ID Nka 45

Nka API (23)

ID Mpaghara Ebe Mbata
omni-auth auth Nnyenye ikike + njikwa session
omni-providers providers Njikwa njikọ provider
omni-models models Katalọgụ model na ikike ya
omni-combos-routing combos-routing Atụmatụ combo routing
omni-api-keys api-keys Njikwa igodo API
omni-usage-logs usage-logs Ndekọ ojiji na ụgwọ
omni-budget budget Nchedo mmefu ego
omni-settings settings Ntọala zuru ụwa ọnụ
omni-proxies proxies Njikwa ọdọ proxy
omni-cache cache Cache semantic + prompt
omni-compression compression Engines mkpakọ context
omni-context-rtk context-rtk Mkpakọ RTK
omni-resilience resilience Circuit breakers + cooldowns
omni-cli-tools cli-tools Proxy REST maka ngwá ọrụ CLI
omni-tunnels tunnels Njikwa tunnel
omni-sync-cloud sync-cloud Mmekọrịta cloud
omni-db-backups db-backups Ndabere database
omni-webhooks webhooks Onye nkesa mmemme webhook
omni-mcp mcp Server MCP (ngwá ọrụ 110, transports 3)
omni-agents-a2a agents-a2a Protocol agent A2A
omni-version-manager version-manager Njikwa version na mmelite
omni-inference inference Inference / completions ozugbo

Nka CLI (21)

ID Mpaghara Mgbọrọgwụ Iwu CLI
cli-serve cli-serve omniroute serve
cli-health cli-health omniroute health
cli-providers cli-providers omniroute providers
cli-keys cli-keys omniroute keys
cli-models cli-models omniroute models
cli-chat cli-chat omniroute chat
cli-routing cli-routing omniroute routing
cli-resilience cli-resilience omniroute resilience
cli-compression cli-compression omniroute compression
cli-contexts cli-contexts omniroute contexts
cli-cost-usage cli-cost-usage omniroute cost
cli-mcp cli-mcp omniroute mcp
cli-a2a cli-a2a omniroute a2a
cli-tunnel cli-tunnel omniroute tunnel
cli-backup-sync cli-backup-sync omniroute backup
cli-policy-audit cli-policy-audit omniroute policy
cli-batches cli-batches omniroute batch
cli-eval cli-eval omniroute eval
cli-plugins-skills cli-plugins-skills omniroute plugins
cli-setup cli-setup omniroute setup
cli-skill-collector cli-setup omniroute skills

Usoro nhazi (1)

ID Mpaghara Ebe Mbata
config-codex-cli config-codex-cli Usoro nhazi Codex CLI

Otu Ndị Nnọchi Anya Mpụga Si Eji Nkà

1. Nchọpụta site na REST

# Nweta katalọgụ zuru ezu
curl "http://your-omniroute/api/agent-skills" | jq '.skills[] | {id, name, category}'

# Nweta SKILL.md maka itinye ọnọdụ gbara ya gburugburu
curl "http://your-omniroute/api/agent-skills/omni-providers/raw" > omni-providers.md

2. Nchọpụta site na MCP

// N'ime klayenti MCP nke Claude Desktop / Cursor:
const result = await client.callTool("omniroute_agent_skills_list", {
  category: "api",
});
// result.skills → usoro AgentSkill nwere rawUrl maka nke ọ bụla

3. Nchọpụta site na A2A

import requests

resp = requests.post("http://your-omniroute/a2a", json={
    "jsonrpc": "2.0", "id": "1",
    "method": "message/send",
    "params": {"skill": "list-capabilities", "messages": [{"role": "user", "content": "list"}]}
})
table = resp.json()["result"]["artifacts"][0]["content"]
# table bụ tebụl markdown nwere ID nkà 45 niile + kọlụm rawUrl

4. Nweta raw ozugbo na GitHub (achọghị sava)

BASE="https://raw.githubusercontent.com/diegosouzapw/OmniRoute/refs/heads/main/skills"
curl "${BASE}/omni-providers/SKILL.md"

Ihe Nwepụta

Ihe nrụpụta ahụ na-agụ katalọgụ ahaziri ahazi + nkọwapụta OpenAPI + ndekọ CLI wee dee skills/{id}/SKILL.md maka ndenye ọ bụla:

# Lelee tupu oge eruo (nnwale akọrọ, enweghị ide ihe)
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer <admin-key>" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":true}'

# Mmepụta ọhụrụ zuru ezu
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer <admin-key>" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":false,"prune":false}'

# Mepụta ID ụfọdụ ọzọ
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer <admin-key>" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":false,"onlyIds":["omni-providers","cli-serve"]}'

Nzaghachi ihe nrụpụta ahụ bụ GeneratorReport:

{
  "generated": ["omni-providers", "cli-serve"],
  "unchanged": [],
  "pruned": [],
  "orphansDetected": [],
  "errors": []
}

API Mkpuchi

curl "http://localhost:20128/api/agent-skills/coverage"
{
  "api": { "have": 23, "total": 23 },
  "cli": { "have": 21, "total": 21 },
  "config": { "have": 1, "total": 1 },
  "totalSkills": 45,
  "generatedAt": "2026-08-02T00:00:00.000Z"
}

Ihe Ndị Metụtara Ya

  • SKILLS.md — usoro Omni Skills (itinye ngwaọrụ LLM + ebe ahịa)
  • MCP-SERVER.md — katalọgụ ngwaọrụ MCP (ngwaọrụ omniroute_agent_skills_*)
  • A2A-SERVER.md — protokol A2A (nkà list-capabilities)
  • src/lib/agentSkills/ — katalọgụ, ihe nrụpụta, ndị ntụgharị
  • skills/ — faịlụ SKILL.md emepụtara (ndenye 45)