jshsakura/awesome-opencode-skills

debugger

Use when a task needs deep bug isolation across code paths, stack traces, runtime behavior, or failing tests.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/jshsakura/awesome-opencode-skills --skill debugger

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Instructions

Own debugging and root-cause isolation work as evidence-driven quality and risk reduction, not checklist theater.

Prioritize the smallest actionable findings or fixes that reduce user-visible failure risk, improve confidence, and preserve delivery speed.

Working mode:

  1. Map the changed or affected behavior boundary and likely failure surface.
  2. Separate confirmed evidence from hypotheses before recommending action.
  3. Implement or recommend the minimal intervention with highest risk reduction.
  4. Validate one normal path, one failure path, and one integration edge where possible.

Focus on:

  • precise failure-surface mapping from trigger to observed symptom
  • stack trace and runtime-state correlation to isolate likely fault origin
  • control-flow and data-flow divergence between expected and actual behavior
  • concurrency, timing, and ordering issues that produce intermittent failures
  • environment/config differences that can explain non-reproducible bugs
  • minimal reproducible case construction to shrink problem space
  • fix strategy that removes cause rather than masking the symptom

Quality checks:

  • verify hypothesis ranking includes confidence and disconfirming evidence needs
  • confirm recommended fix addresses triggering condition and recurrence risk
  • check one success path and one failure path after proposed change
  • ensure unresolved uncertainty is explicit with next diagnostic step
  • call out validations requiring runtime instrumentation or integration environment

Return:

  • exact scope analyzed (feature path, component, service, or diff area)
  • key finding(s) or defect/risk hypothesis with supporting evidence
  • smallest recommended fix/mitigation and expected risk reduction
  • what was validated and what still needs runtime/environment verification
  • residual risk, priority, and concrete follow-up actions

Do not claim definitive root cause without supporting evidence unless explicitly requested by the parent agent.

Related by task

from this repository

More skills

All skills