error-recoverer

Original：🇺🇸 English
Translated
4 scriptsChecked / no sensitive code detected

Intelligent error detection and recovery for autonomous coding. Use when handling errors, implementing retry logic, recovering from failures, or managing exception handling.

11installs
Sourceadaptationio/skrillz
Added on

NPX Install

npx skill4agent add adaptationio/skrillz error-recoverer

Tags

Translated version includes tags in frontmatter
error-recoveryautonomous-codingexception-handlingretry-strategyerror-classification

SKILL.md Content

View Translation Comparison →

Error Recoverer

Detects, classifies, and recovers from errors during autonomous coding sessions.

Quick Start

Handle Error

python
from scripts.error_recoverer import ErrorRecoverer

recoverer = ErrorRecoverer(project_dir)
result = await recoverer.handle_error(error, context)

if result.recovered:
    print(f"Recovered via: {result.strategy}")
else:
    print(f"Failed: {result.reason}")

Automatic Recovery

python
@recoverer.with_recovery
async def risky_operation():
    # Operation that might fail
    pass

Error Recovery Workflow

┌─────────────────────────────────────────────────────────────┐
│                    ERROR RECOVERY FLOW                      │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. DETECT                                                  │
│     ├─ Catch exception                                     │
│     ├─ Parse error message                                 │
│     └─ Extract error context                               │
│                                                             │
│  2. CLASSIFY                                                │
│     ├─ Determine error category                            │
│     ├─ Assess severity level                               │
│     └─ Check if recoverable                                │
│                                                             │
│  3. STRATEGIZE                                              │
│     ├─ Query causal memory for similar errors              │
│     ├─ Select recovery strategy                            │
│     └─ Prepare recovery action                             │
│                                                             │
│  4. RECOVER                                                 │
│     ├─ Execute recovery strategy                           │
│     ├─ Verify recovery success                             │
│     └─ Store error→solution chain                          │
│                                                             │
│  5. ESCALATE (if recovery fails)                           │
│     ├─ Rollback to checkpoint                              │
│     ├─ Create detailed error report                        │
│     └─ Signal for human intervention                       │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Error Categories

CategoryExamplesRecovery Strategy
TransientNetwork timeout, rate limitRetry with backoff
ResourceFile not found, permission deniedFix path/permissions
SyntaxParse error, invalid JSONFix syntax errors
LogicTest failure, assertion errorDebug and fix code
EnvironmentMissing dependency, version mismatchInstall/update deps
UnrecoverableDisk full, OOMEscalate immediately

Recovery Strategies

python
class RecoveryStrategy(Enum):
    RETRY = "retry"              # Simple retry
    RETRY_BACKOFF = "backoff"    # Exponential backoff
    ROLLBACK = "rollback"        # Restore checkpoint
    FIX_AND_RETRY = "fix_retry"  # Apply fix, then retry
    SKIP = "skip"                # Skip and continue
    ESCALATE = "escalate"        # Human intervention

Integration Points

  • memory-manager: Query/store causal chains
  • checkpoint-manager: Rollback on failure
  • coding-agent: Provide fixes for code errors
  • progress-tracker: Log error metrics

References

  • references/ERROR-CATEGORIES.md
    - Error classification
  • references/RECOVERY-STRATEGIES.md
    - Strategy details

Scripts

  • scripts/error_recoverer.py
    - Core recovery logic
  • scripts/error_classifier.py
    - Error classification
  • scripts/retry_handler.py
    - Retry with backoff
  • scripts/recovery_strategies.py
    - Strategy implementations