🐞
QualityJavaScript

Debugging and Error Recovery

by addyosmani

Debugging and Error Recovery is a Quality skill for Claude Code, published by addyosmani in agent-skills.

86.7K stars9.3K forkson addyosmani/agent-skillsAdded 2026/08/13Repository updated 2026/08/11
agent-skillsantigravityclaude-codecodexcursorskills
Install in seconds
Install Debugging and Error Recovery
Copy Debugging and Error Recovery into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/addyosmani/agent-skills/tree/main/skills/debugging-and-error-recovery ~/.claude/skills/debugging-and-error-recovery

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/addyosmani/agent-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/debugging-and-error-recovery/SKILL.md in addyosmani/agent-skills
Installs to
~/.claude/skills/debugging-and-error-recovery
Collection
One of 24 skills cataloged from this repository
Category
Quality1354 skills

What Debugging and Error Recovery does

Debugging and Error Recovery guides systematic root-cause debugging when tests fail, builds break, behavior doesn't match expectations, or any unexpected error occurs. Use it to follow a structured triage process to find and fix the root cause rather than guessing.

Debugging and Error Recovery is cataloged under Quality on DirSkills. Debugging and Error Recovery comes from a repository tagged agent-skills, antigravity, claude-code, codex and cursor.

Documentation

README

Debugging and Error Recovery

Overview

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. Guessing wastes time. The triage checklist works for test failures, build errors, runtime bugs, and production incidents.

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

The Stop-the-Line Rule

When anything unexpected happens:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Debugging and Error Recovery

  • What else does addyosmani publish alongside Debugging and Error Recovery?

    Debugging and Error Recovery is one of 24 skills that DirSkills catalogs from addyosmani/agent-skills, the repository it ships in. Its siblings there include API and Interface Design, Agent Skill Discovery and Browser Testing. Each one is a separate skill with its own page in this directory, installs the same way Debugging and Error Recovery does, and is maintained by addyosmani in that same repository. The rest of the collection is listed on the addyosmani/agent-skills page.

  • How does Debugging and Error Recovery compare to other Quality skills?

    Debugging and Error Recovery ranks #20 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Debugging and Error Recovery against them. Open each page to compare what they document and how they install.

More from addyosmani/agent-skills

Debugging and Error Recovery is one of 24 skills cataloged on DirSkills from addyosmani/agent-skills.

See all 24 skills
🔌
3w ago

API and Interface Design

API and Interface Design guides the creation of stable, well-documented interfaces including REST APIs, GraphQL schemas, module boundaries, and component props. Use it when designing new endpoints, defining contracts between teams, or changing existing public interfaces.
Quality
86.7K9.3K
🧭
3w ago

Agent Skill Discovery

Agent Skill Discovery discovers and invokes agent skills, helping an agent identify the right engineering workflow for a task. Use it when starting a session or when unsure which skill applies.
AI Engineering
86.7K9.3K
🧪
3w ago

Browser Testing

Browser Testing runs tests and inspections in a real browser via Chrome DevTools MCP. Use it when building or debugging browser UI to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output.
Quality
86.7K9.3K
🚀
3w ago

CI/CD and Automation

CI/CD and Automation sets up and modifies build and deployment pipelines, automating quality gates like lint, type check, tests, build, and security audits so no change reaches production without passing checks.
DevOps
86.7K9.3K
🔍
3w ago

Code Review and Quality

Code Review and Quality conducts multi-axis code review across correctness, readability, architecture, security, and performance before merging changes. Use it to assess code quality before code enters the main branch.
Quality
86.7K9.3K
🧹
3w ago

Code Simplification

Code Simplification simplifies code by reducing complexity while preserving exact behavior. Use it when refactoring for clarity, improving readability, or reviewing code that has accumulated unnecessary complexity.
Quality
86.7K9.3K