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
- 参考文档references/basic-fallback-pattern.md1.7 KB
- 参考文档references/configuration-examples.md796 B
- 参考文档references/error-specific-fallback-logic.md1.3 KB
- 参考文档references/errors.md323 B
- 参考文档references/examples.md3.8 KB
- 参考文档references/fallback-health-tracking.md2.0 KB
- 参考文档references/provider-based-fallback.md1.2 KB
- 参考文档references/smart-fallback-configuration.md2.1 KB
- 参考文档references/task-specific-fallbacks.md2.1 KB
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
- Use OpenRouter's native fallback: Pass an array of model IDs in the
modelsfield (instead ofmodel) — OpenRouter will try each in order until one succeeds - Set per-model parameters: Use the
routefield with"fallback"strategy to let OpenRouter handle failover automatically - Implement client-side fallback: For more control, catch 5xx or timeout errors and retry with the next model in your own fallback list
- Configure timeout thresholds: Set
request_timeoutper attempt so slow models fail fast and the fallback triggers quickly - 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
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.
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.
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.
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.
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.
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'.