Skip to main content
AI/MLdvcrn

openrouter-toolkit

The definitive OpenRouter skill — intelligent model routing by task type, cost tracking with budget alerts, automatic fallback chains, side-by-side model comparison, and savings recommendations. Use for optimizing AI model selection, controlling costs, and building resilient LLM pipelines.

Stars
15
Source
dvcrn/openclaw-skills-marketplace
Updated
2026-05-29
Slug
dvcrn--openclaw-skills-marketplace--openrouter-toolkit
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/dvcrn/openclaw-skills-marketplace/HEAD/plugins/aiwithabidi--openrouter-toolkit/skills/openrouter-toolkit/SKILL.md -o .claude/skills/openrouter-toolkit.md

Drops the SKILL.md into .claude/skills/openrouter-toolkit.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

🔀 OpenRouter Toolkit

The definitive OpenRouter skill for OpenClaw agents. Intelligent model routing, cost tracking, fallback chains, and model comparison — all in one toolkit.

Features

  • Smart Routing — Automatically pick the best model for code, reasoning, creative, fast, or cheap tasks
  • Cost Tracking — Log every API call with cost, track daily/weekly/monthly spend
  • Fallback Chains — If primary model fails or times out, auto-retry with fallbacks
  • Model Comparison — Send the same prompt to N models, compare quality and cost side-by-side
  • Budget Alerts — Set spending limits and get warned before you blow your budget
  • Live Model Data — Pulls real pricing and capabilities from OpenRouter's API

Requirements

  • OPENROUTER_API_KEY — Your OpenRouter API key
  • Python 3.10+ with requests (included in most environments)

Usage

Smart Routing

python3 {baseDir}/scripts/openrouter_toolkit.py route --task code
python3 {baseDir}/scripts/openrouter_toolkit.py route --task reasoning
python3 {baseDir}/scripts/openrouter_toolkit.py route --task creative
python3 {baseDir}/scripts/openrouter_toolkit.py route --task fast
python3 {baseDir}/scripts/openrouter_toolkit.py route --task cheap

Model Comparison

python3 {baseDir}/scripts/openrouter_toolkit.py compare --prompt "Explain recursion" --models "anthropic/claude-sonnet-4,openai/gpt-4o-mini"

Fallback Chain

python3 {baseDir}/scripts/openrouter_toolkit.py fallback --prompt "Hello" --chain "anthropic/claude-opus-4,anthropic/claude-sonnet-4,openai/gpt-4o-mini"

Cost Tracking

python3 {baseDir}/scripts/openrouter_toolkit.py cost --period daily
python3 {baseDir}/scripts/openrouter_toolkit.py cost --period weekly
python3 {baseDir}/scripts/openrouter_toolkit.py cost --period monthly

Budget Alerts

python3 {baseDir}/scripts/openrouter_toolkit.py budget --set 50.00
python3 {baseDir}/scripts/openrouter_toolkit.py budget --check

List Models

python3 {baseDir}/scripts/openrouter_toolkit.py models --top 20
python3 {baseDir}/scripts/openrouter_toolkit.py models --search claude
python3 {baseDir}/scripts/openrouter_toolkit.py models --best code

How Smart Routing Works

The router scores models based on task type using these heuristics:

Task Prioritizes Example Models
code High context, code benchmarks Claude Opus, GPT-4o
reasoning Thinking/reasoning capability Claude Opus, o1
creative Creative writing quality Claude Sonnet, GPT-4o
fast Low latency, good enough quality Claude Haiku, GPT-4o-mini
cheap Lowest cost per token Gemini Flash, GPT-4o-mini

Data Storage

Cost logs are stored in SQLite at {baseDir}/data/openrouter_costs.db.

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation