Back to catalog

Addy debugging-and-error-recovery

A systematic debugging skill that pushes the agent to preserve evidence and find root cause instead of guessing.

Repository
addyosmani/agent-skills
Skill path
skills/debugging-and-error-recovery/SKILL.md
Systems
Claude Code, Codex, Cursor, Windsurf / Devin, OpenCode, Zed
Install
npx add-skill addyosmani/agent-skills
GitHub stars
48,672
Updated
2026-06-06
Source
README · SKILL.md

What it is

debugging-and-error-recovery is a structured root-cause debugging skill. The source file tells the agent to stop adding features when something unexpected happens, preserve evidence, and triage deliberately.

Why it is useful

It helps avoid the common agent failure mode of patching symptoms until a test passes once. It applies to test failures, build errors, runtime bugs, console errors, and production incidents.

Best uses

  • A test suite starts failing after a change.
  • Build or runtime errors appear.
  • A bug report needs evidence before a fix.

Notes

This skill is process-heavy. For tiny one-line fixes, use judgment; for unclear failures, it is a strong default.