debugging-and-error-recovery is agent-read markdown (skill) from jpeetz/agent-skills: 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..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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.
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
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 agent 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.
jpeetz/agent-skills · skills/api-backend/har-api-reverse-engineering/SKILL.md · Use this skill when an agent needs to call a website's hidden or undocumented API: capture real browser requests into a…
jpeetz/agent-skills · skills/api-backend/image-to-image-character-generation/SKILL.md · Use this skill when an agent needs to generate consistent character images via kie.ai grok-imagine image-to-image from…
jpeetz/agent-skills · skills/api-backend/social-har-api-connectivity/SKILL.md · Use this skill when an agent needs to connect to a social platform's API by prompting the user to pick a platform…
jpeetz/agent-skills · skills/business-strategy/app-discovery-scrutiny/SKILL.md · Use this skill when the user wants to evaluate a mobile app idea for commercial viability — whether it's a clone…
jpeetz/agent-skills · skills/business-strategy/enterprise-consulting-methods/SKILL.md · Use when you need McKinsey/BCG-grade strategy work — problem decomposition, hypothesis testing, storyline building…
jpeetz/agent-skills · skills/code-quality/code-simplification/SKILL.md · Use this skill when refactoring code for clarity without changing behavior. Use when code works but is harder to read…
addyosmani/agent-skills · skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
shashankswe2020-ux/whoop-mcp · .github/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-cursor/.cursor/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you…
