debug

Diagnose software failures with ranked root-cause hypotheses and file:line evidence.

4|3|Updated May 2, 2026
One-click install
npx skills add https://github.com/ggemba/squad-mcp --skill debug-ggemba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/ggemba/squad-mcp/tree/main/skills/debug
Command: npx skills add https://github.com/ggemba/squad-mcp --skill debug-ggemba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand why a bug is happening by producing a ranked set of plausible root-cause hypotheses, each tied to specific file:line evidence and a fast verification you can run.

Core Features & Use Cases

  • Ranked bug hypotheses (read-only): Returns 1/3/5 causes depending on debug mode, without proposing code changes.
  • Evidence-first orientation: Uses code-explorer lookups to ground hypotheses in concrete file:line locations, marking any speculative items clearly.
  • Cheap discrimination checks: Provides a single verification step per hypothesis intended to be runnable within about a minute.

Quick Start

Use the debug skill by running: /squad:debug --normal "500 errors started after the rate-limit change" and include any available stack trace or repro steps after the description.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I investigate a software bug with ranked root cause hypotheses?

This skill provides read-only debugging by generating ranked root-cause hypotheses for software failures, grounding each cause in specific file:line evidence from code-explorer lookups. It evaluates bug reports alongside available stack traces and repro steps to identify plausible failure causes without making code edits.

What is the best way to diagnose a 500 error using a stack trace and repro steps?

The best way to diagnose a 500 error is to run the skill in normal mode with your bug description, stack trace, and repro steps. It analyzes the provided evidence to output a ranked list of plausible root causes, each paired with a single, fast verification check to confirm the issue.

Does this debugging tool provide code patches and edits for bug fixes?

No, this debugging tool strictly enforces read-only operation and never proposes code patches or makes code edits. It focuses solely on diagnosis by providing evidenced root-cause hypotheses and cheap discrimination checks to help you understand the failure before you modify anything.

Can I use this skill to analyze codebase reasoning for failures without modifying files?

Yes, you can use this skill to perform read-only codebase reasoning to diagnose failures across quick, normal, and deep investigation modes. It safely analyzes your codebase to generate grounded hypotheses and explicitly labels any speculative items that lack concrete file:line evidence.

How do I verify a root cause hypothesis quickly during bug investigation?

To verify a root cause hypothesis quickly, the skill provides a single, cheap discrimination check per hypothesis that is designed to be runnable within about a minute. This fast verification step allows you to confirm or eliminate each plausible cause efficiently during your bug investigation.