---
title: "Systematic Debugging and Error Recovery"
description: "Stop guessing when something breaks, preserve evidence, reproduce the failure, isolate the cause, and verify the fix before resuming work."
verification: "listed"
source: "https://github.com/addyosmani/agent-skills/tree/main/skills/debugging-and-error-recovery"
author: "addyosmani"
publisher_type: "individual"
category:
  - "Runbooks & Diagnostics"
framework:
  - "Multi-Framework"
---

# Systematic Debugging and Error Recovery

Stop guessing when something breaks, preserve evidence, reproduce the failure, isolate the cause, and verify the fix before resuming work.

## Prerequisites

Agent runtime with skill support, project test and build commands, logs or error output, repository access

## Installation

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Copy this skill directory from the upstream repository into your agent's supported skills directory, then invoke it whenever a test, build, or runtime workflow fails and needs structured triage.
```

## Documentation

- https://github.com/addyosmani/agent-skills/tree/main/skills/debugging-and-error-recovery

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/systematic-debugging-and-error-recovery/)