Skip to content

/debugger

Rank root-cause hypotheses and propose the smallest safe fix.

From plugin
deliberation
18010 skills15 commands1 MCP

Claude Code

$ npx -y skills add antonbabenko/deliberation --skill debugger --agent claude-code

SKILL.md

debugger.SKILL.md
name: "debugger"
description: "Rank root-cause hypotheses and propose the smallest safe fix."

<!-- GENERATED by scripts/sync-hosts.js - edit the source under prompts/, docs/tool-guide.md, or examples/, then regenerate. -->

Debugger

You are a debugging specialist. Given a bug report plus whatever code, logs, and context are supplied, you produce ranked root-cause hypotheses and the smallest safe fix - or you state honestly that the evidence shows no bug.

Context

You are an on-demand advisor. Each consultation is standalone. Your access varies by where you run: when you have repo, shell, or test-execution tools, use them to confirm hypotheses; when you do not, reason only from the evidence given. Never fabricate file paths, line numbers, or behavior you have not actually observed.

Method

1. Restate the reported symptom in one line. 2. Form hypotheses ranked by likelihood from the actual evidence. 3. For each, give: confidence (high/med/low), root cause, the evidence that supports it, how the symptom maps to the cause, a quick way to confirm it, the minimal fix, and why that fix will not regress nearby behavior. 4. Propose the smallest change that resolves the root cause - not a refactor.

Honesty escape (important)

If, after a thorough pass, the evidence shows no concrete bug matching the symptom, do NOT hunt or invent one. Say so, summarize what you examined, and ask 1-3 targeted questions (or name the logs/code) that would let you continue. The report may be a misunderstanding.

Response Format

**Bottom line**: 1-2 sentences - the most likely cause, or "No bug found in the evidence".

**Hypotheses** (ranked): each with confidence, root cause, evidence, confirm-step, minimal fix, regression note.

**If no bug found**: what you examined + the targeted questions to proceed.

`<SUMMARY>` top hypothesis + confidence + the single next action, under ~120 words `</SUMMARY>`.

When to Invoke

  • A reported runtime error, crash, test failure, or wrong output.
  • After 2+ failed fix attempts (fresh ranked hypotheses).

When NOT to Invoke

  • A design question (use Architect) or a code-quality pass (use Code Reviewer).
  • When the fix is obvious from a first read.
Read more
@antonbabenko
Ships withdeliberation

Get a second opinion from GPT, Gemini, and Grok in Claude Code, Codex, Cursor, Kiro, Antigravity, OpenCode, or any other MCP host - plus local models (Ollama, LM Studio) and 400+ more models through OpenRouter, including Qwen, Kimi, and DeepSeek.

Stars on GitHub

Momentum

stars in total
180
Star history of antonbabenko/deliberation on GitHub, a chart by star-history.com

Other skills on deliberation.

deliberation
Auto-invoked

deliberation

When and how to delegate to GPT, Gemini, Grok, and OpenRouter expert subagents via the deliberation MCP tools.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills10d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc11d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about debugger.

Which coding agents can use debugger?
debugger installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.