OmniRoute Agent Skills Catalog

개요

카탈로그에는 45개의 Agent Skills(REST API 23개 + CLI 21개 + 구성 워크플로 1개)가 포함되어 있습니다. 각 스킬에는 다음 항목이 있습니다.

• 정식 ID(omni-auth, cli-serve 등)
• YAML 프런트매터(name, description)와 풍부한 마크다운 본문을 포함하는 skills/{id}/SKILL.md의 SKILL.md 파일
• OpenAPI 명세 및 CLI 레지스트리에서 파생된 REST 엔드포인트(API 스킬) 또는 CLI 하위 명령어(CLI 스킬)
• 실시간 가져오기를 위한 GitHub 원시 URL: https://raw.githubusercontent.com/diegosouzapw/OmniRoute/refs/heads/main/skills/{id}/SKILL.md

---

아키텍처

src/shared/constants/agentSkills.ts    — 45개 항목으로 엄선된 목록(이름/설명/카테고리/영역/아이콘)
src/lib/agentSkills/
  catalog.ts                           — getCatalog(), getSkillById(), filterCatalog(), computeCoverage()
  generator.ts                         — generateAgentSkills()가 skills/{id}/에 SKILL.md 작성
  openapiParser.ts                     — docs/openapi.yaml에서 REST 엔드포인트 추출
  cliRegistryParser.ts                 — bin/cli-registry.ts에서 CLI 하위 명령어 추출
  schemas.ts                           — Zod 스키마: AgentSkillSchema, SkillCoverageSchema 등
  types.ts                             — TypeScript 인터페이스: AgentSkill, SkillCoverage 등

skills/{id}/SKILL.md                   — 생성 및 선별된 마크다운 파일(총 45개)

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 (인증 필요)

open-sse/mcp-server/tools/agentSkillTools.ts  — MCP 도구 3개(목록, 조회, 커버리지)
src/lib/a2a/skills/listCapabilities.ts        — A2A 스킬: list-capabilities

---

SKILL.md 형식

---
name: omni-providers
description: "공급자 연결 관리: 자격 증명을 추가, 테스트, 교체 및 제거합니다."
---

<!-- src/lib/agentSkills/generator.ts에서 생성됨. 수동 편집 내용은 덮어쓰입니다. -->

## 개요

...

## 인증

...

## 엔드포인트

...

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

## 사용자 지정 섹션(재생성 시에도 보존됨)

...

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

생성기는 재생성 시 <!-- skill:custom-start -->와 <!-- skill:custom-end --> 사이의 콘텐츠를 보존합니다. 다음 10개 스킬에는 선별된 사용자 지정 블록이 있습니다.

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

---

REST API 탐색

엔드포인트	메서드	설명	인증
/api/agent-skills	GET	카탈로그 목록(선택 사항: ?category=api|cli|config&area=<area>)	없음
/api/agent-skills/{id}	GET	단일 스킬 메타데이터 조회	없음
/api/agent-skills/{id}/raw	GET	SKILL.md를 text/markdown으로 가져오기	없음
/api/agent-skills/coverage	GET	커버리지 통계(존재하는 SKILL.md 파일 수)	없음
/api/agent-skills/generate	POST	생성기 실행(dryRun/prune/onlyIds)	관리

예시 — 모든 API 스킬 나열:

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

예시 — 단일 SKILL.md 가져오기:

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

---

MCP 탐색

read:catalog 범위에 세 개의 MCP 도구가 등록되어 있습니다:

도구	설명
omniroute_agent_skills_list	스킬 목록(선택적 category / area 필터)
omniroute_agent_skills_get	id로 단일 스킬의 메타데이터 + SKILL.md 조회
omniroute_agent_skills_coverage	커버리지 통계(API/CLI 보유 수/전체 수)

범위 연결 및 인증에 대해서는 MCP-SERVER.md를 참조하세요.

---

A2A 탐색

A2A 스킬 list-capabilities는 45개 스킬 전체 카탈로그를 마크다운 표 아티팩트로 반환합니다. 외부 오케스트레이터는 다음을 통해 이를 호출할 수 있습니다:

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

프로토콜 세부 정보는 A2A-SERVER.md를 참조하세요.

---

카탈로그 — 45개 스킬 ID

API 스킬(23)

ID	영역	진입점
omni-auth	auth	인증 + 세션 관리
omni-providers	providers	제공자 연결 관리
omni-models	models	모델 카탈로그 및 기능
omni-combos-routing	combos-routing	콤보 라우팅 전략
omni-api-keys	api-keys	API 키 관리
omni-usage-logs	usage-logs	사용량 및 비용 로그
omni-budget	budget	예산 보호 장치
omni-settings	settings	전역 설정
omni-proxies	proxies	프록시 풀 관리
omni-cache	cache	시맨틱 + 프롬프트 캐시
omni-compression	compression	컨텍스트 압축 엔진
omni-context-rtk	context-rtk	RTK 압축
omni-resilience	resilience	회로 차단기 + 쿨다운
omni-cli-tools	cli-tools	CLI 도구 REST 프록시
omni-tunnels	tunnels	터널 관리
omni-sync-cloud	sync-cloud	클라우드 동기화
omni-db-backups	db-backups	데이터베이스 백업
omni-webhooks	webhooks	웹후크 이벤트 디스패처
omni-mcp	mcp	MCP 서버(도구 110개, 전송 방식 3개)
omni-agents-a2a	agents-a2a	A2A 에이전트 프로토콜
omni-version-manager	version-manager	버전 및 업데이트 관리
omni-inference	inference	직접 추론 / 완성

CLI 스킬(21)

ID	영역	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

구성 워크플로(1)

ID	영역	진입점
config-codex-cli	config-codex-cli	Codex CLI 구성 워크플로

---

외부 에이전트가 스킬을 사용하는 방법

1. REST를 통한 검색

# 전체 카탈로그 가져오기
curl "http://your-omniroute/api/agent-skills" | jq '.skills[] | {id, name, category}'

# 컨텍스트 주입을 위한 SKILL.md 가져오기
curl "http://your-omniroute/api/agent-skills/omni-providers/raw" > omni-providers.md

2. MCP를 통한 검색

// Claude Desktop / Cursor MCP 클라이언트에서:
const result = await client.callTool("omniroute_agent_skills_list", {
  category: "api",
});
// result.skills → 각각에 rawUrl이 포함된 AgentSkill 배열

3. 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은 45개 스킬 ID 전체와 rawUrl 열이 포함된 마크다운 테이블

4. GitHub 원시 파일 직접 가져오기(서버 불필요)

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

---

생성기

생성기는 선별된 카탈로그 + OpenAPI 명세 + CLI 레지스트리를 읽고 각 항목에 대해 skills/{id}/SKILL.md를 작성합니다.

# 미리보기(드라이 런, 파일을 작성하지 않음)
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer <admin-key>" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":true}'

# 전체 재생성
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}'

# 특정 ID 재생성
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"]}'

생성기 응답은 GeneratorReport입니다.

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

---

커버리지 API

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"
}

---

관련 문서

• SKILLS.md — Omni Skills 프레임워크(LLM 도구 주입 + 마켓플레이스)
• MCP-SERVER.md — MCP 도구 카탈로그(omniroute_agent_skills_* 도구)
• A2A-SERVER.md — A2A 프로토콜(list-capabilities 스킬)
• src/lib/agentSkills/ — 카탈로그, 생성기, 파서
• skills/ — 생성된 SKILL.md 파일(45개 항목)

---

undefined (a58000c7685f)