콘텐츠로 이동
OmniRoute Docs

언어 선택

현재 언어: 한국어

OmniRoute source

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 형식

섹션 제목: “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 탐색

섹션 제목: “REST API 탐색”
엔드포인트 메서드 설명 인증
/api/agent-skills GET 카탈로그 목록(선택 사항: ?category=api|cli|config&area=&lt;area&gt;) 없음
/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 탐색

섹션 제목: “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 탐색”

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

섹션 제목: “카탈로그 — 45개 스킬 ID”

API 스킬(23)

섹션 제목: “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)

섹션 제목: “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)

섹션 제목: “구성 워크플로(1)”
ID 영역 진입점
config-codex-cli config-codex-cli Codex CLI 구성 워크플로

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

섹션 제목: “외부 에이전트가 스킬을 사용하는 방법”

1. REST를 통한 검색

섹션 제목: “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를 통한 검색

섹션 제목: “2. MCP를 통한 검색”
// Claude Desktop / Cursor MCP 클라이언트에서:
const result = await client.callTool("omniroute_agent_skills_list", {
  category: "api",
});
// result.skills → 각각에 rawUrl이 포함된 AgentSkill 배열

3. A2A를 통한 검색

섹션 제목: “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 원시 파일 직접 가져오기(서버 불필요)

섹션 제목: “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 &lt;admin-key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":true}'


# 전체 재생성
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer &lt;admin-key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":false,"prune":false}'


# 특정 ID 재생성
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer &lt;admin-key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":false,"onlyIds":["omni-providers","cli-serve"]}'

생성기 응답은 GeneratorReport입니다.

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

커버리지 API

섹션 제목: “커버리지 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개 항목)

OmniRoute 소스 코드 (a58000c7685f)

HagiCode

HagiCode는 구조화된 워크플로, 다중 에이전트 실행, Hero Dungeon 뷰를 갖춘 에이전트 코딩 작업 공간입니다.

더 스마트하고 빠르며 즐거운 에이전트 워크플로로 유용한 소프트웨어를 만드세요.

HagiCode 라이트 테마 메인 화면
  • Smart구조화된 워크플로는 의도를 아이디어부터 배포까지 실행 가능한 경로로 바꿉니다.
  • Efficient다중 에이전트 워크플로로 조사, 구현, 검토를 병렬로 진행합니다.
  • FunHero Dungeon은 긴 코딩 세션을 시각적이고 협업적인 경험으로 만듭니다.
HagiCode 방문