# Debugging And Error Recovery (agent skill)

> Debugging And Error Recovery is an agent skill (a SKILL.md file) from addyosmani/agent-skills. Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or… It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 102,166 GitHub stars across a repository of 13 listed skills.

Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need to figure out what broke and why — a systematic approach to finding and fixing the root cause rather than guessing. Systematic debugging with structured triage. When something breaks, stop adding features, preserve evidence, and follow a structured process to find and fix the root cause.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/addyosmani/agent-skills |
| Skill path | skills/debugging-and-error-recovery/SKILL.md |
| Skill name | debugging-and-error-recovery |
| GitHub stars | 102,166 |
| Installs on skills.sh | 825 |
| License | MIT |
| Skills in repo | 13 |
| Plugin marketplace | addy-agent-skills |
| Official | no |
| Works with | Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode |
| Category | Testing & QA |
| Last commit | Oct 3, 2026 |

## When it triggers

- Use when tests fail, builds break, something that worked yesterday broke, behavior doesn't match expectations, or you encounter any unexpected error.
- Use when you need to figure out what broke and why — a systematic approach to finding and fixing the root cause rather than guessing.

## Add this skill

### Claude Code

```sh
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/addyosmani/agent-skills.git
cp -r agent-skills/skills/debugging-and-error-recovery .agents/skills/debugging-and-error-recovery   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/addyosmani/agent-skills.git
cp -r agent-skills/skills/debugging-and-error-recovery .cursor/skills/debugging-and-error-recovery   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

skills.sh listing: https://www.skills.sh/addyosmani/agent-skills/debugging-and-error-recovery

---

Canonical page: https://appsgit.com/skills/addyosmani-debugging-and-error-recovery
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.