agentsclimarketplace

Debugging craft

Skill ljojua1998/skills/.claude/skills/debugging-craft

Systematic debugging method — feedback loop first, reproduce and minimize, ranked falsifiable hypotheses, targeted instrumentation, regression-test-before-fix. Use whenever diagnosing a bug or a failing finding.From its SKILL.md

Install
npx -y skills add ljojua1998/skills --skill debugging-craft

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.2 KB, as published. Nobody here has run it

Debugging Craft

Six phases, in order. The discipline is the value — skipping phase 1 is how debugging turns into guessing.

1. Build a feedback loop (most important)

Before theorizing, get a deterministic, fast pass/fail signal that goes red on this bug. Ranked options: a failing test at the nearest seam → HTTP script against the dev server → CLI run with fixture input → headless browser drive → minimal repro harness. If you have this loop, you will find the cause; if you don't, you're guessing.

2. Reproduce and minimize

Shrink to the smallest failing case — remove one element at a time (data fields, config, middleware, steps) until removing anything makes it pass. The remainder points at the cause.

3. Hypothesize

Write 3–5 falsifiable hypotheses ranked by likelihood, each with a testable prediction ("if H1, then adding X will show Y"). Test the cheapest-to-check first. Never fix on an untested hypothesis.

4. Instrument

Probes mapped to specific predictions — not scattergun logging. Prefer a debugger or targeted assertions over log spam. Tag every temporary probe (e.g. // DEBUG:) so cleanup is mechanical.

5. Fix and regression-test

Write the regression test before the fix — watch it fail on the bug, then pass with the fix. Fix the root cause minimally; check whether the same root cause exists elsewhere in the codebase and fix all instances. Run the surrounding suite for regressions.

6. Clean up and capture

Remove all probes and debug artifacts. Record in the ticket/log: symptom → root cause → fix → verification, plus (when it's structural) what would prevent this class of bug.

Honesty rules

  • Cannot reproduce → report exactly what you tried; never "fix" blind.
  • Finding is actually intended behavior → dispute it with reasoning; don't change code.
  • A fix without a re-run red→green signal is not a fix — don't report it as one.

Keep looking

Skills are one crate of 610,220. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.