← Back to Skills Marketplace
bevanding

Smart Model Router

by bevanding · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
81
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install model-router-pro
Description
Route every substantive user request to the optimal LLM model. Trigger on EVERY substantive request. Score across 12 dimensions, pick the best model, switch...
README (SKILL.md)

Smart Model Router

Every Substantive Request

  1. Score: python3 \x3Cskill_path>/scripts/router.py --task "\x3Cuser message>"
  2. Parse JSON → get full_id, tier, confidence
  3. If full_id is fallback/default: do NOT switch. Tell the user to run --setup.
  4. If full_id differs from current model: session_status(model=\x3Cfull_id>)
  5. Answer the user. Do not volunteer routing details, but disclose when asked.

Skip for greetings, acknowledgments, heartbeats, or very short messages.

First-Time Setup

python3 \x3Cskill_path>/scripts/router.py --setup

Recommended: Reinforce in AGENTS.md

Add the following line to your agent's AGENTS.md for reliable auto-trigger:

Always follow smart-model-router SKILL.md instructions on every substantive request.

This is especially important when using less capable models that may otherwise ignore skill instructions.

CLI

--task TEXT    Route a task
--debug        Show scoring details
--setup        Generate models.json
Usage Guidance
This skill appears to do what it says: it scores messages and recommends a model, reading ~/.openclaw/openclaw.json to see which models are available. Before installing: - Run the provided --setup once and inspect the generated models.json and models database (capabilities_defaults.json) so automatic switching uses sensible defaults for your environment. If you don't configure models, the router intentionally returns fallback/default and will not switch. - Be aware the router executes on every substantive request (it will run the bundled Python script), which can add latency; test in a safe environment first. - The README suggests adding a note to AGENTS.md to reinforce agent compliance — avoid making the agent override other safety controls just to satisfy the skill. Only add such enforcement if you trust the skill and your agent's policy setup. - Confirm that ~/.openclaw/openclaw.json contains the model IDs you expect; the router filters out models not present there, which may cause no candidates if your config differs from the skill's database. No scan alerts were found in the supplied bundle, and no unrelated credentials or network endpoints are present in the code. If you want higher assurance, run the script locally and review its output on representative prompts before enabling automatic routing.
Capability Analysis
Type: OpenClaw Skill Name: model-router-pro Version: 1.1.0 The 'model-router-pro' skill is a legitimate utility designed to optimize LLM usage by routing tasks to models based on a 12-dimension complexity analysis. It includes a setup script (`router.py`) that reads the local OpenClaw configuration (`~/.openclaw/openclaw.json`) to identify available models, a process that is transparently declared in `SKILL.md`. The bundle relies solely on the Python standard library, performs no network operations, and shows no signs of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
Name/description (model routing) match the included code and files: a 12-dimension scorer, a models database, and logic to read available models and pick one. Asking to read ~/.openclaw/openclaw.json to detect available models is proportionate to model-availability filtering.
Instruction Scope
SKILL.md only instructs running the local Python scorer, parsing its JSON output, optionally switching session model via session_status(), and to skip trivial messages. The metadata declares access to ~/.openclaw/openclaw.json, which the code actually reads. The instructions do not ask for unrelated files, credentials, or data exfiltration.
Install Mechanism
No install spec is provided (instruction-only). Code files are bundled with the skill; they are local and use only Python stdlib. No downloads, external URLs, or package installs are present.
Credentials
The skill declares no required environment variables or credentials. The code reads the user's home OpenClaw config (~/.openclaw/openclaw.json) and optional models/config JSON files — these are relevant to its job. No secrets or unrelated env access are requested.
Persistence & Privilege
Skill does not request always:true and does not modify other skills' configurations. It runs locally when invoked and relies on the agent to follow SKILL.md. The README suggestion to add a line to AGENTS.md to force compliance is advisory, not a capability change in the skill itself.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install model-router-pro
  3. After installation, invoke the skill by name or use /model-router-pro
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Setup now detects AGENTS.md and prints copy-paste hint for auto-routing enablement
v1.0.4
Add AGENTS.md reinforcement recommendation to SKILL.md for reliable auto-trigger
v1.0.3
Fix: clarify that AGENTS.md reinforcement is recommended for agent compliance
v1.0.2
Add installation section: ClawHub install + auto-activation + --setup instructions
v1.0.1
Fix security scan: declare configPaths in metadata, remove transparency concern
v1.0.0
- Initial release of smart-model-router skill. - Automatically routes every substantive user request to the optimal LLM model based on 12 scoring dimensions. - Excludes greetings, acknowledgments, heartbeats, and very short messages from routing. - Provides CLI for task routing, debug info, and initial model setup. - Ensures fallback handling with user guidance if setup is missing.
Metadata
Slug model-router-pro
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is Smart Model Router?

Route every substantive user request to the optimal LLM model. Trigger on EVERY substantive request. Score across 12 dimensions, pick the best model, switch... It is an AI Agent Skill for Claude Code / OpenClaw, with 81 downloads so far.

How do I install Smart Model Router?

Run "/install model-router-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Smart Model Router free?

Yes, Smart Model Router is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Smart Model Router support?

Smart Model Router is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Smart Model Router?

It is built and maintained by bevanding (@bevanding); the current version is v1.1.0.

💬 Comments