debugging-and-error-recovery SKILL.md skillA

debugging-and-error-recovery from jpeetz/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add jpeetz/agent-skills/debugging-and-error-recovery@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

jpeetz/agent-skills

Path

skills/code-quality/debugging-and-error-recovery/SKILL.md

Versions recorded

1

Latest version

v1.0.0, committed Sep 21, 2026

Size

11,882 bytes

Repository stars

16

License

none declared

Use this skill when tests fail, builds break, runtime behavior doesn't match expectations, a bug report arrives, or something worked yesterday and stopped working. Guides systematic root-cause debugging with structured triage, anti-rationalization tables, and verification gates — no guessing, no skipped steps.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Debugging and Error Recovery

## Overview

When something breaks, stop adding features, preserve evidence, and follow a structured process to find and fix the root cause. Guessing wastes time — the triage checklist below works for test failures, build errors, runtime bugs, and production incidents.

Work through the 6-step process in order. Do not skip steps.

## When to Use

- Tests fail after a code change
- The build breaks
- Runtime behavior doesn't match expectations
- A bug report arrives
- An error appears in logs or console
- Something worked before and stopped working
- A production incident or alert fires

## Process — The 6-Step Triage

### Step 0: Stop the Line

```
1. STOP adding features or making changes
2. PRESERVE evidence (error output, logs, repro steps)
3. DIAGNOSE using the triage checklist below
4. FIX the root cause
5. GUARD against recurrence
6. RESUME only after verification passes
```

**Don't push past a failing test or broken build to work on the next feature.** Errors compound. A bug in Step 3 that goes unfixed makes Steps 4–6 wrong.

### Step 1: Reproduce

Make the failure happen reliably. If you can't reproduce it, you can't fix it with confidence.
…

Read the whole file at its exact version.

How to install

mdr add jpeetz/agent-skills/debugging-and-error-recovery@sha256:95d4cfdc24022033

[![mdr](https://markdownregistry.com/badge/art_wbkxriuy7uicksn7.svg)](https://markdownregistry.com/a/art_wbkxriuy7uicksn7)

Versions

The registry has recorded 1 version of this file, committed on Sep 21, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_wbkxriuy7uicksn7
GET https://markdownregistry.com/api/v1/resolve?ref=jpeetz/agent-skills/debugging-and-error-recovery
GET https://markdownregistry.com/api/v1/blob/95d4cfdc24022033b0e978b7ff080be2e29a694d3866ccadbf1bcb8dcbf3571b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jpeetz/agent-skills

Every file in jpeetz/agent-skills

Other files named debugging-and-error-recovery

Browse by kind, by grade A, or by owner.