Catalog
Yeachan-Heo/models

Interactive setup for role-based model routing: edit team.roleRouting (provider, tier, per-provider reasoning effort; orchestrator model-only), check panel diversity, warn on missing provider CLIs.

v1.0LATEST
NewUpdated Nov 8, 2026

Models

Setup wizard for role-based model routing. OMC resolves each agent role to a provider, model, and reasoning effort through team.roleRouting in the project config (.claude/omc.jsonc) or the user config at claude-omc/config.jsonc under OMC's platform config dir — $XDG_CONFIG_HOME (default ~/.config) on POSIX, %APPDATA% on Windows, the same resolver getConfigPaths() uses — never a hard-coded ~/.config path. Run omc config to see the effective values before editing. This skill reads the current routing, walks the user through changes, writes the block, and checks panel diversity. It never edits config silently.

What is configurable

Per role (canonical names: orchestrator, planner, analyst, architect, executor, debugger, critic, code-reviewer, security-reviewer, test-engineer, designer, writer, code-simplifier, explore, document-specialist):

{
  "team": {
    "roleRouting": {
      "executor": { "provider": "claude", "model": "MEDIUM", "reasoningEffort": "high" },
      "code-reviewer": { "provider": "codex" }
    }
  }
}
  • provider: claude | codex | gemini | grok | cursor | antigravity — except orchestrator, which is pinned to Claude
  • model: tier HIGH | MEDIUM | LOW, or an explicit model ID — the only key orchestrator accepts; provider and reasoningEffort are rejected for it (config validation fails closed at team start), so the wizard offers model-only for that role
  • reasoningEffort: per-provider only — Claude low|medium|high|xhigh|max, Codex low|medium|high|xhigh|max|ultra, Antigravity low|medium|high|max; Gemini, Grok, and Cursor accept no effort field. Offer only the seated provider's set — an off-list value is rejected at config load by validateTeamConfig, before any team starts
  • unset roles keep their defaults; routing is resolved once at team start and frozen for that run

Workflow

  1. Show current resolution: read the active config file(s) and print each configured role with provider/model/effort, marking defaults.
  2. Ask what to change — one role at a time, offering the tiers and, when the user has provider CLIs installed, cross-provider options. Confirm each choice before writing.
  3. Write the block with a single atomic edit to the project config unless the user asks for user scope. Preserve every other key and all comments where the format allows.
  4. Re-read the file and print the resulting resolution for confirmation.
  5. Warn on provider CLIs that are not installed (codex, gemini, grok, cursor-agent, agy) — routing to a missing CLI fails closed at team start.

Panel diversity check

Multi-model panel runs work best when the panel spans model families. Before such a run, check the seated panel: if every seat is the same provider and the same model family, recommend diversifying one seat to a different family. Two seats on one family plus one on another is acceptable; three identical seats defeats the mechanism and should be called out before the run starts.

Notes

  • This skill only writes configuration. It never starts a team, spawns agents, or changes model routing for an already-running team.
  • delegationRouting is partially deprecated: entries routing to the external Codex/Gemini providers should migrate into team.roleRouting; valid Claude Task routes (including agentType and fallback settings) are a separate subsystem and must stay where they are — team.roleRouting governs /team only, Task delegation is not moved by this skill.
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

78/100

Grade

B

Good

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

82

Quality

75

Clarity

82

Completeness

68

Summary

This skill guides an agent through interactive configuration of role-based model routing in OMC (OpenModelConversation) projects. It reads the effective config, walks users through provider/model/reasoning-effort choices per role, writes changes atomically to project or user config, and validates panel diversity before multi-model runs.

Detected Capabilities

config file readconfig file writeJSON/JSONC parsinguser interactionCLI detectionfile preservation (comments, unrelated keys)

Trigger Keywords

Phrases that agents use to match this skill to user intent.

configure model routingset team providersmulti-model panel setupswitch agent modelsmodel tier selection

Risk Signals

INFO

Reads config from platform-specific paths ($XDG_CONFIG_HOME, %APPDATA%) without hardcoding fallbacks

Overview section
INFO

Writes to project config (.claude/omc.jsonc) or user config (claude-omc/config.jsonc)

Workflow section, step 3
INFO

Accesses environment variables to resolve config directories

Overview section

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.com

Use Cases

  • Configure model routing for multi-agent teams
  • Switch providers or tiers per role interactively
  • Validate panel diversity before multi-model panel runs
  • Check installed provider CLIs before routing
  • Migrate legacy delegationRouting to team.roleRouting

Quality Notes

  • Clear role taxonomy with 15 canonical role names provided
  • Explicit constraints per role documented (e.g., orchestrator accepts model-only, provider pinned to Claude)
  • Per-provider reasoning effort options well-defined and constraint-listed
  • Workflow has 5 discrete, sequential steps with confirmation gates (step 2, 3)
  • Panel diversity check logic clearly explained (same provider+family is problematic; two families acceptable)
  • Important boundaries well-documented: no team spawning, no runtime routing changes, delegationRouting migration notes
  • Strongly recommends `omc config` to preview values before editing
  • Writes described as atomic with comment preservation
  • Missing: concrete example of resulting .claude/omc.jsonc or user config after write
  • Missing: error handling guidance (e.g., what if validation fails, what if file is unreadable)
  • Missing: which CLI commands to run to verify provider installation (lists provider names but not detection method)
Model: claude-haiku-4-5-20251001Analyzed: Nov 8, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use Yeachan-Heo/models in your dev environment

Command Palette

Search for a command to run...