debugging-wizard

Diagnose Kotlin/JVM bugs, coroutine deadlocks, and runtime errors with stack traces.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Astrumon/Spovishun --skill debugging-wizard-astrumon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-wizard
Source: https://github.com/Astrumon/Spovishun/tree/main/.claude/skills/debugging-wizard
Command: npx skills add https://github.com/Astrumon/Spovishun --skill debugging-wizard-astrumon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers systematically diagnose and resolve software bugs, runtime exceptions, coroutine deadlocks, and unexpected behavior by enforcing reproducible investigation and evidence-driven fixes.

Core Features & Use Cases

  • Reproducible Investigation Workflow: Step-by-step methodology to reproduce issues, gather logs and stack traces, form hypotheses, verify one at a time, and prevent regressions with tests.
  • Kotlin/JVM and Coroutine Patterns: Practical guidance for coroutine deadlocks, CancellationException handling, Exposed ORM transaction errors, and NullPointerException root-cause analysis.
  • Regression Hunting & Reporting: Integrates git-bisect guidance and a concise root cause report format that links evidence to the exact failing line, proposed fix, and prevention steps.
  • Use Case: When a Telegram bot built on Kotlin hangs in production with no output, use this Skill to collect thread dumps, reproduce the hang locally, trace coroutine misuse, and produce a regression test.

Quick Start

Invoke the debugging-wizard with a concise reproduction description, the full stack trace and logs, environment details, and the failing test or steps to receive a prioritized root cause analysis and verification plan.

Frequently Asked Questions about debugging-wizard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Kotlin coroutine deadlock or hang in production?

Debug a Kotlin coroutine deadlock by collecting thread dumps and logs, reproducing the hang locally, and tracing coroutine misuse or CancellationException handling errors to isolate the root cause.

What is the best way to find a root cause from a JVM stack trace?

Finding a root cause from a JVM stack trace requires reproducing the issue, forming hypotheses, and verifying each one against evidence like logs and failing tests to link the exact failing line to a proposed fix.

How do I use git-bisect to find a regression causing a CI failure?

Git-bisect finds a regression by systematically narrowing down commits until the exact failing change is identified, running tests at each step to verify whether the bug is present and linking the regression to a specific code change.

Does this debugging workflow help with Exposed ORM transaction errors?

Yes, this debugging workflow helps with Exposed ORM transaction errors by applying a reproducible investigation methodology to isolate runtime exceptions and verify hypotheses against transaction logs and stack traces to find the root cause.

What do I need to diagnose a NullPointerException in a Kotlin project?

To diagnose a NullPointerException in a Kotlin project, you need reproduction steps, the full stack trace, and environment details to perform hypothesis-driven verification and create a regression test to prevent future occurrences.

When should I use a systematic root-cause analysis for runtime errors instead of quick fixes?

Use systematic root-cause analysis for runtime errors when you need to prevent regressions and understand unexpected behavior fully, enforcing evidence-driven fixes by linking stack traces to exact failing lines and proposed solutions to avoid recurring issues.