agent-model-healer

Switch unhealthy scheduled agents to healthy fallback models via MCP calls.

23|4|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/marlandoj/zouroboros --skill agent-model-healer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-model-healer
Source: https://github.com/marlandoj/zouroboros/tree/main/Skills/agent-model-healer
Command: npx skills add https://github.com/marlandoj/zouroboros --skill agent-model-healer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

Zouroboros self-healing watchdog that monitors model health across all scheduled agents. When a model fails (402 credits, 429 rate limit, 503 unavailable, timeout), the healer automatically switches affected agents to the next healthy fallback model. When the original model recovers, it restores agents to their preferred model. Runs as a scheduled watchdog agent.

Core Features & Use Cases

  • Automatic health monitoring: continuously checks configured models and detects unhealthy states.
  • Deterministic failover: moves affected agents to the next healthy fallback model and preserves a rollback path.
  • Zero-cost orchestration: performs agent management via direct MCP calls and minimal probe cost.
  • Auditable actions: maintains a per-agent switch history and state for auditing.

Quick Start

Configure and run the healer on a schedule to automatically probe models, switch unhealthy agents to fallbacks, and restore originals when they recover.

Frequently Asked Questions about agent-model-healer

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

FAQPage Schema
How do I automatically switch scheduled agents to a fallback model when an API fails?

Automatically switch scheduled agents to a fallback model by running a self-healing watchdog that probes model health, detects failures like 402 or 429 errors, and moves affected agents to the next healthy model. The healer restores original models when they recover.

What is self-healing model availability management for autonomous agents?

Self-healing model availability management is a watchdog process that continuously monitors scheduled agents, probes for unhealthy model states, and dynamically switches agents to healthy fallback models to prevent downtime.

How do I monitor model health and detect rate limits or unavailable errors across my agents?

Monitor model health by applying probes via /zo/ask to detect specific failures like 402 credits, 429 rate limits, 503 unavailable errors, and timeouts across your scheduled agents, triggering automatic failover when unhealthy states are found.

Can I restore my agents to their original models after an API outage resolves?

Yes, you can restore agents to their original models automatically. The healer preserves a rollback path during failover and switches agents back to their preferred model once health checks confirm the original model has recovered.

Does the self-healing agent failover process keep a history of model switches for auditing?

Yes, the self-healing failover process maintains a per-agent switch history and state for auditing. It tracks all model switch actions and sends email notifications when failover or restoration events occur.

Do I need direct MCP calls to orchestrate model failover across scheduled agents?

Yes, you need deterministic MCP calls to orchestrate end-to-end model failover across scheduled agents. The healer performs agent management via these direct calls to switch unhealthy agents and restore originals during recovery.