debugging-toolkit-smart-debug

Diagnose software issues through structured triage, observability analysis, and root cause workflows.

2|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/monang404/lunawave --skill debugging-toolkit-smart-debug-monang404
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debugging-toolkit-smart-debug
Source: https://github.com/monang404/lunawave/tree/main/.agent/skills/debugging-toolkit-smart-debug
Command: npx skills add https://github.com/monang404/lunawave --skill debugging-toolkit-smart-debug-monang404

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging production and staging issues often involves scattered logs, unclear stack traces, and guesswork. This Skill provides a structured, end-to-end debugging workflow that moves from initial triage through hypothesis generation, instrumentation, root cause analysis, fix validation, and prevention. ## Core Features & Use Cases - Structured Triage & Hypothesis Ranking: Parses error messages, stack traces, and failure patterns to generate 3-5 ranked hypotheses with probability scores and falsification criteria. - Observability-Driven Analysis: Guides data collection from error trackers (Sentry, Rollbar), APM tools (DataDog, New Relic), distributed tracing (Jaeger, Honeycomb), and log aggregation platforms. - Production-Safe Debugging Techniques: Covers dynamic instrumentation, feature-flagged debug logging, sampling-based profiling, and canary deployments for safe investigation in live environments. - Use Case: Given an intermittent checkout timeout affecting 5% of users, the workflow correlates Sentry errors with DataDog traces, identifies an N+1 query pattern, proposes a batch-query fix, and defines validation and regression-test steps. ## Quick Start Ask the assistant to debug a specific issue by pasting the error message, stack trace, affected environment, and reproduction steps.

Frequently Asked Questions about debugging-toolkit-smart-debug

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

FAQPage Schema
How do I debug intermittent production errors?▼

Intermittent production errors are debugged by correlating error tracking data from Sentry with distributed traces and APM metrics, then generating ranked hypotheses with falsification criteria. Statistical approaches like delta debugging compare success versus failure cases to isolate the cause.

What tools help with root cause analysis in production?▼

Root cause analysis in production typically combines error trackers like Sentry or Rollbar, APM platforms like DataDog or New Relic, distributed tracing via Jaeger or Honeycomb, and log aggregation through ELK, Splunk, or Loki. The workflow correlates these sources to reconstruct execution paths.

How do I debug safely in a live production environment?▼

Production-safe debugging uses non-invasive techniques: dynamic OpenTelemetry instrumentation, feature-flagged debug logging for specific users, sampling-based profiling with tools like Pyroscope, and canary deployments that shift only a small percentage of traffic to debug builds.

When should I use interactive debugging versus observability-driven debugging?▼

Interactive debugging with breakpoints suits issues reproducible locally, while observability-driven debugging fits production issues that cannot be reproduced in development. Time-travel debugging with tools like rr works best for complex state issues, and chaos engineering targets failures under load.

How do I validate that a bug fix actually works?▼

Fix validation involves running the test suite, comparing performance against a baseline, deploying via canary release while monitoring error rates, and reviewing the change for new edge cases. Success means tests pass, no performance regression occurs, and error rates stay flat or decrease.