error-recovery

Handle subagent failures with retry strategies and escalation patterns.

Updated Dec 1, 2025
One-click install
npx skills add https://github.com/Clouder0/dotagent --skill error-recovery-clouder0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-recovery
Source: https://github.com/Clouder0/dotagent/tree/main/.claude/skills/error-recovery
Command: npx skills add https://github.com/Clouder0/dotagent --skill error-recovery-clouder0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Strategies for handling subagent failures with retry logic and escalation patterns.

Core Features & Use Cases

  • Retry strategies: Simple retry, context enhancement, and scope reduction.
  • Escalation: Route to specialized contractors for resolution.

Quick Start

Apply the appropriate recovery strategy based on the failure type and retry limits.

Frequently Asked Questions about error-recovery

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

FAQPage Schema
How do I handle subagent failures and decide whether to retry or escalate?

Subagent failure handling uses retry strategies (simple retry, context enhancement, scope reduction) paired with escalation to specialized contractors. Track retry state and match the recovery strategy to the failure type—context issues trigger context enhancement, complexity triggers scope reduction, and unrecoverable failures escalate or abort with a report.

What retry strategies are available for subagent task failures?

Error recovery implements five strategies: simple retry repeats the task, context enhancement adds detail to improve outcomes, scope reduction breaks the task into smaller steps, escalation routes to specialized contractors, and abort with report halts execution and documents the failure for review.

When should I escalate a subagent failure instead of retrying?

Escalate when retry limits are reached, the failure indicates a knowledge or capability gap, or the error pattern suggests the subagent cannot resolve it independently. Escalation routes the task to specialized contractors equipped to handle the specific failure class.

How does retry state tracking prevent infinite retry loops?

Retry state tracking counts attempts and evaluates failure patterns against configured limits. Once limits are met, the executor stops retrying and moves to escalation or abort, preventing loops and ensuring forward progress through the recovery strategy chain.

Can I combine multiple retry strategies in a single failure recovery?

Yes. Error recovery integrates with the executor loop to apply strategies sequentially—start with simple retry, then context enhancement, then scope reduction. Each strategy builds on prior attempts; if all fail, escalate or abort based on failure severity and retry exhaustion.

Related Skills