hook-runtime-fallback

Detect runtime errors and switch to prioritized fallback models during active sessions.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/xuezhaojun/oh-your-opencode --skill hook-runtime-fallback
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hook-runtime-fallback
Source: https://github.com/xuezhaojun/oh-your-opencode/tree/main/.opencode/skills/hook-runtime-fallback
Command: npx skills add https://github.com/xuezhaojun/oh-your-opencode --skill hook-runtime-fallback

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects runtime errors (HTTP 429 rate limits, overload, timeout, capacity errors) and automatically retries with fallback models from a priority list. Unlike model-fallback which handles model unavailability at session start, this reacts to errors in real-time during a session.

Core Features & Use Cases

  • Auto-selects and rotates through a prioritized fallback model list when runtime errors occur.
  • Works across multi-provider setups to improve reliability during long sessions.
  • Use case: keep a conversation going by switching to available fallback providers when primary becomes temporarily unavailable.

Quick Start

Configure the runtime-fallback hook with a prioritized fallback list and cooldown to enable automatic runtime error handling.

Frequently Asked Questions about hook-runtime-fallback

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle AI model rate limits and timeouts during an active session?

Switch to available fallback providers during long-running conversations by configuring an auto-retry hook with a prioritized fallback model list. This rotates across multi-provider setups to maintain session availability when the primary provider temporarily fails.

What is the difference between runtime fallback and session start model fallback?

Runtime fallback reacts to transient errors like HTTP 429 rate limits during an active session, whereas session start model fallback handles model unavailability before the conversation begins. Runtime fallback auto-switches models in real-time to keep ongoing sessions running.

Can I configure cooldown periods for AI model fallback rotation?

Yes, you can configure cooldown periods for AI model fallback rotation. The runtime fallback hook exposes configuration options for cooldowns and rotation modes, allowing you to control exactly how fallbacks rotate and recover after transient runtime errors occur.

Does runtime fallback work across multi-provider AI setups?

Runtime fallback works across multi-provider AI setups to improve reliability. It automatically detects runtime errors and selects alternative models from a prioritized fallback list, ensuring continuous availability across different providers during long sessions.

What types of runtime errors trigger automatic fallback to another AI model?

Automatic fallback to another AI model is triggered by transient runtime errors such as HTTP 429 rate limits, overload, timeout, and capacity errors. The hook detects these errors in real-time and rotates to the next available provider.