Skip to content
Kitbay
Skill

debugging-and-error-recovery

MITUpdated on Nov 1, 2026115,373GitHub stars

A skill from Addy Osmani's agent-skills collection for when tests fail, builds break or behaviour stops matching expectations.

What the skill teaches

A skill from Addy Osmani's agent-skills collection for when tests fail, builds break or behaviour stops matching expectations. The agent stops adding features, keeps the evidence, and works through a triage checklist: reproduce the failure, localise it, including with git bisect to find the commit that introduced it, reduce it to a minimal case, fix the root cause rather than the symptom, add a test that guards against a repeat, and verify end to end with the failing test, the full suite and a build. It adds triage steps for test, build and runtime errors and patterns for safe fallbacks.

Capabilities

  • Stop feature work and preserve evidence when something breaks
  • Reproduce, localise and reduce a failure
  • Find the commit that introduced a bug with git bisect
  • Fix the root cause and add a regression guard