slug: skill

AI Skill — Let your agent configure OAR

OAR ships with a skill file (skills/oar.md) that teaches any AI agent — Claude Code, Cursor, Codex, Gemini CLI, etc. — how to configure OAR for you. Instead of clicking through the dashboard manually, just tell your agent to read the skill and set everything up.

How it works

  1. The skill file is a single Markdown document that describes every OAR CLI command, the architecture, protocol conversion rules, and typical workflows.
  2. Your AI agent reads it (via @skills/oar.md, file attachment, or project context) and gains full knowledge of how to drive OAR.
  3. You ask in natural language: "Add my DeepSeek key, create a coding group with deepseek-chat and deepseek-reasoner, and bind it to Claude Code." — the agent runs the right oar commands.
Zero UI required

The skill lets you configure OAR entirely from your editor or terminal. The dashboard is always there if you prefer a GUI, but the skill makes CLI-first setup effortless.

Get the skill

The skill file lives in the project repo at skills/oar.md. If you installed via the desktop app or the install script, you can also grab it directly:

download skill — bash
$ curl -fsSL https://raw.githubusercontent.com/SnowAIGGirl/open-agent-router/master/skills/oar.md -o oar.md

Then reference it from your agent:

  • Claude Code / Codex / Hermes — drop oar.md into your project root or .skills/ directory; the agent picks it up as context.
  • Cursor / Continue — add it to your project rules or @-mention it in chat.
  • Gemini CLI — pass it via --context oar.md or paste the content into your prompt.
  • Any agent — paste the file contents into the chat and ask it to configure OAR.

Example prompts

Once your agent has the skill loaded, try these:

You sayAgent does
"Add my OpenAI key and sync models"oar account create + oar account sync
"Create a coding group with gpt-5 and deepseek-v3, weighted"oar group create + oar group add-model
"Point Claude Code at the coding group"oar agent set-group claude-cli + oar agent regenerate
"Set up a project for my repo and bind it to the fast group"oar project create + oar project add-agent + oar project gen-config
"Recover all cooled-down models in the coding group"oar group recover coding

What the skill covers

The skill file documents:

  • All CLI commands — service management, accounts, groups, agents, projects, settings, usage, capture
  • Architecture — single binary, single port, SQLite + in-memory cache, protocol conversion matrix
  • Typical workflows — first-time setup, adding providers, creating groups, binding agents, project routing
  • Tips & common issues — port conflicts, model sync, config regeneration, cooldown recovery
  • CLI conventions — --name flags, true/false booleans, --json output mode

Skill + Desktop = best of both worlds

The skill is not a replacement for the desktop app — it's a complement. Use the skill for fast, repeatable, scriptable setup. Use the dashboard for visual inspection, live logs, and request capture. Both talk to the same backend on 127.0.0.1:26969.

Next, read the Core Concepts to understand platforms, models, groups, agents and projects.

Previous

Quickstart

Next

Core Concepts