debug

Coordinates hypothesis-driven debugging workflows to reproduce, test, and validate software fixes.

8|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/ShaheerKhawaja/ProductionOS --skill debug-shaheerkhawaja
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/ShaheerKhawaja/ProductionOS/tree/main/skills/debug
Command: npx skills add https://github.com/ShaheerKhawaja/ProductionOS --skill debug-shaheerkhawaja

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging that guides reproduction, hypothesis generation, testing, and verification with a clear, traceable workflow.

Core Features & Use Cases

  • Hypothesis-driven debugging: reproduce issues, generate testable hypotheses, and validate fixes.
  • Evidence gathering: collect logs, traces, and version history to justify conclusions.
  • End-to-end workflow: record steps, outcomes, and decisions for audits and knowledge reuse.

Quick Start

Describe the failing bug path and run the /debug command to start the debugging workflow.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I systematically debug software by tracking hypotheses and evidence?

Systematic debugging tracks hypotheses by reproducing issues, generating testable assumptions, and validating fixes with evidence from logs and traces. It provides a structured workflow to record experiments, outcomes, and decisions for future knowledge reuse and audits.

What is hypothesis-driven debugging and when should I use it?

Hypothesis-driven debugging is a structured approach that forms testable assumptions about root causes and validates them with evidence. Use it when facing complex bugs requiring traceable reproduction steps, clear problem isolation, and evidence-based verification across tests and runtime environments.

How do I reproduce a bug and validate fixes using a deterministic workflow?

Reproduce a bug and validate fixes by describing the failing path to initiate a debugging workflow. This deterministic process records reproduction steps, testable hypotheses, experiments, and outcomes, ensuring evidence-based verification of the root cause before applying fixes.

Do I need a bug report and version history to debug software systematically?

Yes, systematic debugging requires a clear bug report, access to version history, and test logs. These inputs provide the necessary evidence to reproduce the issue, form accurate hypotheses, and trace decisions throughout the debugging workflow.

What's the best way to find the root cause of a bug across runtime environments?

The best way to find a root cause is gathering evidence like logs and traces from runtime environments to justify conclusions. A hypothesis-driven workflow records each experiment and outcome, ensuring evidence-based testing leads to an accurate, verifiable root-cause identification.