agentsclimarketplace

Systematic debugging

Skill vrennat/developersDevelopers/skills/systematic-debugging

Use when Claude observes a real error, test failure, or unexpected runtime output during execution. Forms hypothesis, runs minimal experiment, iterates to root cause before any fix.From its SKILL.md

Install
npx -y skills add vrennat/developersDevelopers --skill systematic-debugging

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

  • 2 stars2 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

1.5 KB, as published. Nobody here has run it

Systematic Debugging

Fires when execution produces a real failure: a test error, a stack trace, a non-zero exit code, or output that contradicts the expected behavior. Does NOT fire when the user mentions a bug abstractly without evidence on screen.

Procedure

  1. State observed vs expected in one sentence each.
  2. Form 1-3 hypotheses ranked by likelihood.
  3. Design the smallest experiment that proves or disproves the top hypothesis (a print, a one-line edit, a focused test).
  4. Run the experiment. Capture the output.
  5. Update or replace hypotheses based on the result. Repeat from step 3 until root cause is identified.
  6. State the root cause and the proposed fix. Hand off to /impl or direct implementation.

Example

Observed: `bun run check` reports `TS2339: Property 'roomId' does not exist on type 'GameState'.`
Expected: typecheck passes after the new prop was added.

Hypothesis 1 (likely): roomId was added to ServerState but not propagated to GameState.
Experiment: grep for `interface GameState` to see the actual definition.

Result: GameState extends ClientState, not ServerState. roomId lives on ServerState.

Root cause: prop placement on the wrong type in the layered state hierarchy.
Fix: move roomId to a shared base interface.

Keep looking

Skills are one crate of 609,689. 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.