debug-session

Guide systematic debugging workflows to diagnose and fix codebase issues.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/SpencerGoss/agent-engineering --skill debug-session-spencergoss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-session
Source: https://github.com/SpencerGoss/agent-engineering/tree/main/debug-session
Command: npx skills add https://github.com/SpencerGoss/agent-engineering --skill debug-session-spencergoss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging complex systems often reveals hidden root causes rather than symptoms. This skill provides a disciplined, diagnosis-first workflow to identify and fix issues with structured prompts and guided steps.

Core Features & Use Cases

  • Systematic problem framing and triage for broken code, builds, or experiments.
  • Step-by-step diagnosis with evidence gathering, hypothesis logging, and controlled repro attempts.
  • Reproducible rollback and verification guidance to ensure fixes are safe.

Quick Start

State your observed failure, reproduce it locally, and follow the diagnostic steps to identify and fix the root cause.

Frequently Asked Questions about debug-session

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

FAQPage Schema
How do I systematically diagnose runtime errors and build failures in my codebase?

You can debug performance regressions and unexpected behavior by following a structured workflow that enforces root-cause diagnosis, stepwise evidence collection, and reproducibility checks. This ensures fixes are safe and verified before application.

What is the best way to ensure reproducibility when fixing unexpected software behavior?

Ensuring reproducibility when debugging requires a structured approach enforcing controlled reproduction attempts, hypothesis logging, and reproducibility checks before applying fixes. This guarantees that verified fixes address the true root cause safely.

How do I find the root cause of a performance regression instead of just fixing symptoms?

Finding the root cause of a performance regression involves a diagnosis-first workflow that frames the problem systematically, gathers evidence step-by-step, and logs hypotheses. This disciplined approach prevents superficial symptom treatment and identifies the underlying failure.

Can I use structured debugging prompts for diagnosing broken software experiments?

Yes, structured debugging prompts can be used for diagnosing broken software experiments. The systematic problem framing, triage, and step-by-step diagnosis process applies to broken code, builds, or experiments, guiding you through evidence gathering and controlled reproduction.

How do I verify that a code fix is safe before rolling it back into my project?

Verifying a code fix is safe requires following reproducible rollback and verification guidance after root-cause diagnosis. The structured workflow ensures fixes are validated through controlled attempts and hypothesis logging before final application.

Why does my debugging process keep addressing symptoms instead of the actual root cause?

Debugging processes often address symptoms instead of root causes because they lack a disciplined, diagnosis-first workflow. By enforcing stepwise evidence collection, hypothesis logging, and root-cause diagnosis, you can systematically identify and fix the true underlying issue.