Agent skill

Routerbase Model Gateway

by davepoon in davepoon/buildwithclaude

Integrate and route AI model requests through RouterBase. An agent skill from davepoon/buildwithclaude.

MITAuto-check passedAI & LLM Engineering

Install Routerbase Model Gateway

skills CLI
$ npx skills add davepoon/buildwithclaude --skill routerbase-model-gateway -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davepoon/buildwithclaude routerbase-model-gateway --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/all-skills/skills/routerbase-model-gateway .claude/skills/routerbase-model-gateway && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
routerbase-model-gateway
GitHub stars
3.6k
Token cost
~1.1k tokens
SKILL.md length
477 words
Files
1
Skills in repo
246
Repo updated
First seen
Licence
MIT

At a glance

Integrate and route AI model requests through RouterBase. An agent skill from davepoon/buildwithclaude.

  • Works in 6 steps: Detects the target stack and where the… → Configures the base URL as… → Uses ROUTERBASE_API_KEY as a server-side… → …
  • Migrating OpenAI-compatible clients
  • SKILL.md covers When to Use This Skill, What This Skill Does, How to Use and Integration Pattern, plus 4 more sections
  • Reaches routerbase.com; needs ROUTERBASE_API_KEY

What it does

Routerbase Model Gateway is an agent skill from davepoon/buildwithclaude. Integrate and route AI model requests through RouterBase. Use when migrating OpenAI-compatible clients, choosing model IDs, configuring fallbacks, or building chat, image, video, audio, speech, and embedding workflows.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Embeddings. It works with OpenAI. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

When your agent uses it

  • Migrating OpenAI-compatible clients
  • Choosing model IDs
  • Configuring fallbacks
  • Embedding workflows

Example prompts

  • “/routerbase-model-gateway”

Requirements

  • A credential in ROUTERBASE_API_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Detects the target stack and where the AI provider client should live.
  2. Configures the base URL as https://routerbase.com/v1.
  3. Uses ROUTERBASE_API_KEY as a server-side secret.
  4. Preserves OpenAI-compatible request shapes unless a selected model requires a specific option.
  5. Produces a primary and fallback model plan with validation steps.
  6. Separates synchronous chat/image flows from asynchronous video or audio jobs.

What it can do on your machine

Read from SKILL.md and the folder at commit 616deb5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • routerbase.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ROUTERBASE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Routerbase Model Gateway loads about 1.1k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 477 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davepoon/buildwithclaude at commit 616deb5, republished under its MIT licence (© davepoon). 477 words, ~1,149 tokens.

Download SKILL.mdSave it as .claude/skills/routerbase-model-gateway/SKILL.md (or your agent's skills folder).
name
routerbase-model-gateway
description
Integrate and route AI model requests through RouterBase. Use when migrating OpenAI-compatible clients, choosing model IDs, configuring fallbacks, or building chat, image, video, audio, speech, and embedding workflows.
category
ai-ml

RouterBase Model Gateway

Use routerbase as an OpenAI-compatible model gateway for chat, image, video, audio, speech, and embedding workloads. This skill helps agents migrate existing SDK clients, keep credentials private, choose model IDs, and document safe fallback behavior.

When to Use This Skill

  • The user wants to migrate an OpenAI SDK or OpenAI-compatible integration to RouterBase.
  • The user needs a model routing plan across cost, latency, quality, context length, streaming, tool calling, JSON mode, or vision requirements.
  • The user is adding chat, image, video, audio, speech, or embedding calls to an application.
  • The user is debugging RouterBase auth, endpoint, model ID, streaming, media, or payload issues.
  • The user needs documentation or a smoke-test checklist for a RouterBase integration.

What This Skill Does

  1. Detects the target stack and where the AI provider client should live.
  2. Configures the base URL as https://routerbase.com/v1.
  3. Uses ROUTERBASE_API_KEY as a server-side secret.
  4. Preserves OpenAI-compatible request shapes unless a selected model requires a specific option.
  5. Produces a primary and fallback model plan with validation steps.
  6. Separates synchronous chat/image flows from asynchronous video or audio jobs.

How to Use

Basic Usage
Use routerbase-model-gateway to migrate this OpenAI chat integration to RouterBase.
Use routerbase-model-gateway to design a fallback model plan for low-latency support chat.
Use routerbase-model-gateway to add image and video generation with safe polling and storage.

Integration Pattern

Prefer the user's existing OpenAI-compatible SDK. Change the base URL, store the API key in environment configuration, and keep request payloads standard.

js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ROUTERBASE_API_KEY,
  baseURL: process.env.ROUTERBASE_BASE_URL || "https://routerbase.com/v1",
});

const response = await client.chat.completions.create({
  model: "google/gemini-2.5-flash",
  messages: [{ role: "user", content: "Write one sentence about model routing." }],
});

Routing Plan Format

When recommending models, return a table like this:

markdown
| Use case | Primary model | Fallback model | Reason | Validation |
| --- | --- | --- | --- | --- |
| Support chat | model-id | model-id | Low latency and tool support | Run fixture prompts and compare output shape |

Treat model IDs, pricing, and availability as live data. If a live catalog check is not possible, mark examples clearly and tell the user what must be verified before production.

Show full SKILL.md (223 more words)Show less

Debug Checklist

  • Authentication: missing ROUTERBASE_API_KEY, wrong environment, or server-side secret not loaded.
  • Endpoint: missing /v1, wrong media endpoint, or client still pointing at another provider.
  • Model ID: unavailable, misspelled, disabled for the account, or unsupported for the requested modality.
  • Request shape: unsupported field, invalid content part, invalid tool schema, or model-specific parameter mismatch.
  • Streaming: client does not consume Server-Sent Events or SDK chunks correctly.
  • JSON mode: missing response_format or no downstream schema validation.
  • Async media: task ID not persisted, polling has no timeout, or generated media is not stored before temporary URLs expire.

Guardrails

  • Never paste, infer, print, or log real API keys.
  • Never put RouterBase keys in browser code, mobile apps, screenshots, or public repositories.
  • Do not retry authentication, invalid model, validation, or policy errors blindly.
  • Do not claim example model IDs, pricing, or availability are permanent facts.
  • Validate model-specific support for streaming, tool calling, JSON mode, vision, context length, media size, and async behavior.
  • Require human review for high-impact medical, legal, financial, safety, security, or compliance use cases.

Output

Return:

  1. The target endpoint or base URL.
  2. Required environment variables.
  3. Files to change or create.
  4. A minimal request example.
  5. A model routing table.
  6. Fallback and retry behavior.
  7. Validation or smoke-test steps.
  8. Remaining assumptions that must be checked against live RouterBase docs or account access.

© davepoon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/all-skills/skills/routerbase-model-gateway of davepoon/buildwithclaude.

Open the folder on GitHubat commit 616deb5

Compare with similar skills

Routerbase Model Gateway next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Routerbase Model Gateway compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Routerbase Model Gateway this skilldavepoon/buildwithclaude3.6k—~1.1kAutomated safety check: PassMIT
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k7 repos~2.3kAutomated safety check: PassMIT
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
CLIP Image-Text MatchingOrchestra-Research/AI-Research-SKILLs13k7 repos~1.7kAutomated safety check: PassMIT
Xsaimoeru-ai/airi50k1 repos~1.3kAutomated safety check: PassMIT
Embedding Strategieswshobson/agents40k10 repos~710Automated safety check: PassMIT

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 7 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed
  • CLIP Image-Text Matching

    Orchestra-Research/AI-Research-SKILLs

    Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.

    13k GitHub starsUsed in 7 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Xsai

    moeru-ai/airi

    A skill your agent uses when the user is building with xsai or any @xsai/ package, or is evaluating xsAI for a small OpenAI-compatible workflow with text generation, streaming, tool calling…

    50k GitHub starsUsed in 1 repo~1.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Embedding Strategies

    wshobson/agents

    Helps choose and tune embedding models for semantic search and RAG: model comparison, chunking, preprocessing, normalization and caching.

    40k GitHub starsUsed in 10 repos~710 tokens
    AI & LLM EngineeringAuto-check passed
  • Fastllm Gateway

    azrtydxb/Fastllm-proxy

    Send inference requests through the FastLLM OpenAI-compatible gateway — chat completions, completions, embeddings, rerank, score, responses, moderations, audio speech and transcription, image…

    108 GitHub stars~926 tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed

More from davepoon/buildwithclaude

All 246 skills in this repo
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated today
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated today
    Auto-check passed
  • Browser Extension Launch

    davepoon/buildwithclaude

    面向没有编程经验的用户,把想法做成可试用的浏览器插件,并完成检查、商店材料、审核提交和上线验证;也用于继续已有插件、排错和发布新版。用户说“帮我做个插件”“把插件上架”“继续我的插件”时使用。普通网站开发、仅查询插件知识不触发。

    3.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Works with

Questions about Routerbase Model Gateway

What does Routerbase Model Gateway do?

Integrate and route AI model requests through RouterBase. An agent skill from davepoon/buildwithclaude. Routerbase Model Gateway is an agent skill from davepoon/buildwithclaude. Integrate and route AI model requests through RouterBase.

When should I use Routerbase Model Gateway?

Routerbase Model Gateway fits situations like: migrating OpenAI-compatible clients; choosing model IDs; configuring fallbacks; embedding workflows.

How do I install Routerbase Model Gateway in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill routerbase-model-gateway -a claude-code`. Or copy the skill folder (plugins/all-skills/skills/routerbase-model-gateway in davepoon/buildwithclaude) into .claude/skills/routerbase-model-gateway in your project. Claude Code loads it when a task matches its description.

How do I install Routerbase Model Gateway in Codex?

Run `npx skills add davepoon/buildwithclaude --skill routerbase-model-gateway -a codex`. Or copy the skill folder (plugins/all-skills/skills/routerbase-model-gateway in davepoon/buildwithclaude) into .agents/skills/routerbase-model-gateway in your project. Codex loads it when a task matches its description.

Can I use Routerbase Model Gateway in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davepoon/buildwithclaude --skill routerbase-model-gateway -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/routerbase-model-gateway, .gemini/skills/routerbase-model-gateway, .github/skills/routerbase-model-gateway and .opencode/skills/routerbase-model-gateway in your project.

What does Routerbase Model Gateway need to run?

Going by SKILL.md and its folder, Routerbase Model Gateway needs credentials named ROUTERBASE_API_KEY. Our summary lists: A credential in ROUTERBASE_API_KEY.

Does Routerbase Model Gateway access the network?

SKILL.md names 1 domain. In commands or code: routerbase.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Routerbase Model Gateway safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Routerbase Model Gateway use?

Routerbase Model Gateway is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Routerbase Model Gateway use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Routerbase Model Gateway?

Skills that share tags, products or a category with Routerbase Model Gateway: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars), CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Xsai (moeru-ai/airi, 50k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Routerbase Model Gateway?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,605 GitHub stars. The repository holds 246 skills in this directory. The repository was last updated on October 9, 2026.

Source: davepoon/buildwithclaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.