error-recovery

Preserve evidence and execute recovery decision trees for software failures.

10|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/troykelly/codex-skills --skill error-recovery-troykelly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-recovery
Source: https://github.com/troykelly/codex-skills/tree/main/skills/error-recovery
Command: npx skills add https://github.com/troykelly/codex-skills --skill error-recovery-troykelly

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured approach to handle failures, ensuring that errors are assessed, evidence is preserved, recovery actions are taken, and the system state is verified, minimizing downtime and data loss.

Core Features & Use Cases

  • Systematic Failure Handling: Follows a clear protocol: Assess, Preserve, Recover, Verify, Document.
  • Evidence Preservation: Captures logs, stack traces, and system state before attempting fixes.
  • Decision Tree Recovery: Offers specific recovery strategies for code errors, build errors, environment issues, and external service failures.
  • Verification Steps: Ensures that tests pass, builds succeed, and functionality is restored post-recovery.
  • Use Case: When a critical build fails in CI, this skill can automatically capture the logs, attempt a clean re-install of dependencies, and re-run the build, documenting the process.

Quick Start

Use the error-recovery skill to handle the current failure by assessing its severity and preserving evidence.

Frequently Asked Questions about error-recovery

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

FAQPage Schema
How do I handle CI CD build failures without losing logs and system state?

To handle CI CD build failures without losing data, use a systematic recovery protocol that preserves evidence like logs and stack traces before attempting fixes. This approach assesses severity, captures the environment state, and then executes targeted recovery actions.

What is the best way to recover from environment issues and external service failures during deployment?

The best way to recover from environment issues and external service failures is to follow a decision tree recovery strategy. This method categorizes the failure type and applies predefined recovery steps specific to code, build, environment, or external service disruptions.

How do you verify system integrity after executing error handling and recovery steps?

To verify system integrity after error recovery, run verification steps that ensure tests pass, builds succeed, and functionality is fully restored. This post-recovery validation confirms the system is stable and the failure has been genuinely resolved.

When should I escalate a major error during failure management instead of auto-recovering?

You should escalate a major error during failure management when predefined recovery decision trees fail to resolve the issue. The system assesses severity levels—critical, major, minor, and info—and escalates when automated recovery attempts are exhausted.

Can I automatically document incidents and stack traces when troubleshooting code errors?

Yes, you can automatically document incidents and stack traces when troubleshooting code errors. The recovery protocol includes a documentation phase that records the incident details, preserved evidence, and recovery actions taken for future reference.

Does this failure management protocol work for minor and info severity issues or only critical crashes?

This failure management protocol works for all severity levels, including minor and info severity issues, not just critical crashes. It systematically assesses the severity of code, build, environment, or external service errors to determine the appropriate recovery action.