debug-mode

Generate hypotheses and collect logs to debug JavaScript, Python, and Node backends.

Updated Dec 4, 2025
One-click install
npx skills add https://github.com/Remedy92/debug-mode-plugin --skill debug-mode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-mode
Source: https://github.com/Remedy92/debug-mode-plugin/tree/main/skills/debug-mode
Command: npx skills add https://github.com/Remedy92/debug-mode-plugin --skill debug-mode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of identifying, diagnosing, and fixing software bugs, freeing you from manual debugging loops and tedious log analysis. It streamlines the entire debugging workflow, from hypothesis generation to fix verification.

Core Features & Use Cases

  • Automated Hypothesis Generation: Automatically generates 5-7 potential causes for a bug, then narrows them down to the top 2 most likely culprits.
  • Strategic Log Insertion: Guides you to insert precise, context-rich debug logs ([DEBUG:]) at critical points in your code (e.g., function entry/exit, API boundaries, state mutations).
  • Centralized Log Collection & Analysis: Utilizes a local HTTP server to collect logs from your application, then analyzes them to pinpoint divergences and root causes.
  • Iterative Fix & Verification: Supports an iterative process of implementing fixes, re-running with logs, and verifying the solution, ensuring the bug is truly resolved.
  • Use Case: When your application crashes with an obscure error or you're stuck in a debugging loop, activate this Skill. It will systematically help you identify the problem, add necessary logging, collect runtime data, analyze the fault, and guide you to a verified fix, significantly reducing your debugging time.

Quick Start

Help me debug this issue. My application is crashing with the following error: 'TypeError: Cannot read property 'id' of undefined' in src/components/UserList.js.

Frequently Asked Questions about debug-mode

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

FAQPage Schema
How do I debug code when I'm stuck in a loop with error messages?

Automated debugging generates 5-7 hypotheses about code failures, narrows them to the top 2 culprits, then guides you to insert strategic debug logs at critical points. This accelerates root-cause identification across JavaScript, Python, and Node backends without manual log analysis.

How do I use debug logs to identify where my application is crashing?

Insert [DEBUG:] prefixed logs at function entry/exit, API boundaries, and state mutations. A local HTTP server collects these logs at runtime, then analyzes them to pinpoint divergences between expected and actual execution, revealing the fault location.

Can I automate bug fixing across JavaScript and Python projects?

Yes. This Skill automates hypothesis generation, strategic log insertion, and iterative fix verification for JavaScript, Python, and Node applications. It supports the full workflow from identifying the bug to verifying the solution works.

What's the best way to collect and analyze logs from a running application?

A dedicated local HTTP server collects runtime logs as they're generated, then analyzes them to detect divergences and root causes. This centralized collection eliminates manual log parsing and reduces time spent on fault diagnosis.

How do I verify that a bug fix actually resolved the issue?

After implementing a fix, re-run your application with strategic debug logs enabled, collect the new logs via the local server, and compare against the original logs. Automated analysis confirms whether the divergence is resolved and the bug is truly fixed.