What happens if the error is unrecoverable?

The skill triggers an escalation protocol, summarizing all failed recovery attempts and marking the task as blocked to await human intervention.

Can this skill fix issues with external APIs or services?

While it cannot fix external services, it includes a specific workflow to check service health, implement wait-and-retry logic, and document the external blocker.

Does it automatically revert my code without warning?

The skill announces its intent to use the recovery protocol and uses a decision tree to choose the least invasive recovery method, such as stashing or soft resets, before moving to hard resets.

How does the Error Recovery skill handle potential data loss?

It follows a 'Preserve' step before any recovery actions, capturing git state, logs, and environment variables to ensure evidence is saved before attempting fixes.

Error Recovery Protocol

Name: Error Recovery Protocol
Author: troykelly

bytroykelly

Analytics & Monitoring

Manages software failures through structured assessment, evidence preservation, and systematic recovery workflows.

About

The Error Recovery skill provides Claude with a rigorous framework for handling development failures without panic. It guides the AI to systematically assess error severity, capture critical logs and state before they are lost, and execute a logic-driven recovery decision tree based on the failure type—whether it's a code bug, build error, environment issue, or external service outage. By ensuring rigorous post-recovery verification and automated documentation in issue trackers or memory graphs, this skill minimizes downtime and prevents the 'messy state' often encountered during autonomous coding tasks.

Key Features

Automated evidence preservation for logs, stack traces, and git environment states
Automated post-recovery verification including test suites, build checks, and type-checking
Structured 5-step recovery protocol: Assess, Preserve, Recover, Verify, and Document
Multi-level severity classification to prioritize critical system failures over minor issues
0 GitHub stars
Context-aware decision tree for resolving code, build, environment, and external service errors

Use Cases

Systematically rolling back complex multi-file regressions to the last known good commit
Recovering from corrupted dependencies or broken build artifacts in a local development environment
Diagnosing and documenting flaky tests or environment-specific failures that block CI pipelines

About

Key Features

Automated evidence preservation for logs, stack traces, and git environment states
Automated post-recovery verification including test suites, build checks, and type-checking
Structured 5-step recovery protocol: Assess, Preserve, Recover, Verify, and Document
Multi-level severity classification to prioritize critical system failures over minor issues
0 GitHub stars
Context-aware decision tree for resolving code, build, environment, and external service errors

Use Cases

Systematically rolling back complex multi-file regressions to the last known good commit
Recovering from corrupted dependencies or broken build artifacts in a local development environment
Diagnosing and documenting flaky tests or environment-specific failures that block CI pipelines