agentsclimarketplace
Sign in

Debugging methodology

Skill jagreehal/jagreehal-claude-skills/skills/debugging-methodology

Debugs failures by gathering evidence before proposing fixes, enforcing no fix without root-cause investigation. Use this skill when encountering bugs, test failures, unexpected behavior, intermittents, or works-locally-fails-in-CI, before changing code. Do not use when/for implementing a feature with no failure under investigation, or pure code-flow-analysis without a live failure.From its SKILL.md

Install
npx -y skills add jagreehal/jagreehal-claude-skills --skill debugging-methodology

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

  • 3 stars3 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.4 KB, as published. Nobody here has run it

Debugging Methodology

Critical rules

  • NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. No evidence → no fix proposal.
  • Measure; do not speculate. Instrumentation before hypothesis.
  • One change at a time. Never stack unverified fixes.
  • 3+ failed fixes → stop, question architecture, discuss before more attempts.
  • Red flags: "quick fix now", "try changing X", multi-change batches, "probably X", proposing solutions before data flow is traced.
  • Before instrumenting, map the path with code-flow-analysis. Before deep examples, read references/protocol.md.

Workflow

  1. Document the exact symptom (error text, expected vs actual, inputs, environment).
  2. Add instrumentation at decision points before forming any hypothesis.
  3. For complex flows, use OpenTelemetry spans (or existing production traces).
  4. Form a testable, evidence-based hypothesis that explains all symptoms.
  5. Apply one change; retest; keep structured logging, remove debug-only noise.
  6. For Result / workflow failures: log every err(), each step, and mock interactions. See protocol for patterns.

Resources

  • references/protocol.md — instrumentation, Result/workflow debugging, decision tree, anti-patterns, rationalizations. Read before instrumenting or when stuck.

Validation

  • Exact symptom captured
  • Instrumentation evidence explains the failure (not a guess)
  • Hypothesis confirmed with a single isolating change
  • Root cause identified (not only symptom location)
  • Regression test fails without fix, passes with it
  • Original failure no longer reproduces; suite/build green
  • Debug-level noise removed; structured logs/traces kept

Constraints

  • Skip the full protocol only for trivial self-evident issues the compiler already names (typo, missing import).
  • Related: code-flow-analysis, investigation-modes, result-types, fn-args-deps, verification-before-completion, confidence-levels, observability.

Keep looking

Skills are one crate of 627,801. 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.