- name
- auto-model-router
- description
- >
- version
- 0.2.0
- metadata
- openclaw
- requires
- bins
- env
- description
- Anthropic API key (for Claude models)
- required
- false
- description
- OpenAI API key (for GPT models and embeddings)
- required
- false
- description
- DeepSeek API key (for DeepSeek models)
- required
- false
- description
- MiniMax API key (for MiniMax models)
- required
- false
- description
- Google API key (for Gemini models)
- required
- false
- description
- Optional: URL of a self-hosted router service for learning mode (Mode B). If not set, the skill runs fully locally (Mode A).
- required
- false
- description
- Optional: API key for the self-hosted router service
- required
- false
- user-invocable
- true
- emoji
- 🧠
- homepage
- https://github.com/JoyyyceD/auto-model-router
- privacy
- >
Auto Model Router Skill
You have intelligent model routing. For every substantive task, follow this procedure.
Task Categories
Classify tasks into one of these categories:
| Category | When to use |
|---|---|
coding | Writing code, debugging, implementing features, architecture |
code_review | Reviewing existing code, security/performance analysis |
math_reasoning | Math problems, logic puzzles, quantitative analysis |
writing_long | Articles, reports, essays, long documents |
writing_short | Titles, slogans, social posts, short copy |
translation | Translating between languages |
summarization | Summarizing long texts, meeting notes |
data_analysis | Analyzing data, writing SQL, interpreting charts |
image_understanding | Analyzing or describing images |
daily_chat | Casual Q&A, simple questions, general assistance |
Procedure
Check whether AUTO_MODEL_ROUTER_URL is set to determine which mode to use.
Mode A — Local (default, no router needed)
Use this when AUTO_MODEL_ROUTER_URL is NOT set.
Step 1 — Classify the task yourself
Read the user's task and determine the best category from the table above. Be decisive — pick one category.
Step 2 — Call the model
python3 ~/.claude/skills/auto-model-router/scripts/call_model.py "<category>" "<user task text>"Exit codes:
3— API key missing: tell the user which env var to set4— Config not found: tell the user to runpython3 scripts/setup.py5— No routes configured at all: tell the user to runpython3 scripts/setup.py
Step 3 — Present the result
Show the response naturally. Add a subtle footer: _[auto-model-router: used {category} → {model}]_
Mode B — Router (with learning)
Use this when AUTO_MODEL_ROUTER_URL is set.
Privacy note: Task text and an anonymous session ID are sent to the router at AUTO_MODEL_ROUTER_URL. This URL is always set by the user — the skill has no built-in remote endpoint. If the user has not explicitly set this variable, always use Mode A.Step 1 — Get recommendation
python3 ~/.claude/skills/auto-model-router/scripts/recommend.py "<user task text>" "<USER_ID>"- Capture stdout as the model response.
- Extract
TASK_IDfrom stderr (line starting withTASK_ID=).
Exit codes:
2— Router offline: fall back to Mode A automatically3— API key missing: tell the user which env var to set
Step 2 — Present the result
Same as Mode A Step 3.
Step 3 — Collect feedback
Ask once after presenting the result:
"Was this response helpful? Reply 👍, 👎, or skip."
If 👍:
python3 ~/.claude/skills/auto-model-router/scripts/feedback.py "<TASK_ID>" 1 "<USER_ID>"If 👎:
python3 ~/.claude/skills/auto-model-router/scripts/feedback.py "<TASK_ID>" -1 "<USER_ID>"If skip, do nothing.
Changing Model Assignments
When the user says things like "switch to GPT-4o for translation" or "use DeepSeek for coding":
python3 ~/.claude/skills/auto-model-router/scripts/update_route.py <category> <provider> <model>Examples:
python3 ~/.claude/skills/auto-model-router/scripts/update_route.py translation openai gpt-4o
python3 ~/.claude/skills/auto-model-router/scripts/update_route.py coding deepseek deepseek-chat
python3 ~/.claude/skills/auto-model-router/scripts/update_route.py daily_chat google gemini-2.0-flashConfirm to the user: "Done, {category} tasks will now use {model}."
First-time Setup
If config is missing, tell the user to run:
python3 ~/.claude/skills/auto-model-router/scripts/setup.pyManual Invocation
/auto-model-router <your task>