AGENT SKILL

openrouter-fallback-config

Configure model fallback chains for reliability. Use when building resilient systems that need high availability. Trigger with phrases like 'openrouter fallback', 'model fallback', 'openrouter backup model', 'failover config'.

License 许可
MIT
最近更新
2026-05-26
Stars
★ 0
Forks
0

01 前言 Front Matter

name
openrouter-fallback-config
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
version
1.0.0
description
Configure model fallback chains for reliability. Use when building resilient systems that need high availability. Trigger with phrases like 'openrouter fallback', 'model fallback', 'openrouter backup model', 'failover config'.
allowed-tools
Read, Write, Edit, Grep
compatible-with
claude-code, codex, openclaw

02 资源文件 9

03 SKILL.md 正文

Openrouter Fallback Config

Overview

This skill shows how to configure fallback model chains so requests automatically retry with alternative models when the primary model is unavailable or errors.

Prerequisites

  • OpenRouter integration
  • Multiple models identified as primary and fallback options

Instructions

  1. Use OpenRouter's native fallback: Pass an array of model IDs in the models field (instead of model) — OpenRouter will try each in order until one succeeds
  2. Set per-model parameters: Use the route field with "fallback" strategy to let OpenRouter handle failover automatically
  3. Implement client-side fallback: For more control, catch 5xx or timeout errors and retry with the next model in your own fallback list
  4. Configure timeout thresholds: Set request_timeout per attempt so slow models fail fast and the fallback triggers quickly
  5. Test the chain: Temporarily use an invalid model ID as primary to verify your fallback chain activates correctly

Output

  • A fallback chain that transparently retries with alternative models
  • Reduced downtime when individual models or providers have outages
  • Logs showing which model ultimately served each request

Error Handling

Error Cause Fix
All fallbacks exhausted Every model in the chain failed Add more diverse fallbacks across providers; alert on full chain failure
Slow cascading retries Each model timing out sequentially Reduce per-model timeout to 10-15 seconds; use parallel fallback instead
Inconsistent responses Different models in the chain have different capabilities Ensure all fallback models support the features your prompt uses (e.g., tool calling)

See ${CLAUDE_SKILL_DIR}/references/errors.md for full error reference.

Examples

See ${CLAUDE_SKILL_DIR}/references/examples.md for runnable code samples.

Resources

04 同仓库更多 Skills

SamuelChien
SamuelChien/mega-skills-collection

zustand-store-ts

Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zustand-store-creator

Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zero-trust-config-helper

Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zapier-integration-helper

Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zai-cli

Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

yt-research

Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.

★ 0