diagnose

Diagnose software defects and performance regressions through structured hypothesis testing.

113|23|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/opensage-agent/opensage-adk --skill diagnose-opensage-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/opensage-agent/opensage-adk/tree/main/src/opensage/bash_tools/diagnose
Command: npx skills add https://github.com/opensage-agent/opensage-adk --skill diagnose-opensage-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a rigorous, disciplined framework for resolving hard-to-reproduce bugs and performance regressions, preventing aimless trial-and-error debugging.

Core Features & Use Cases

  • Feedback Loop Construction: Prioritizes the creation of deterministic, agent-runnable test signals to verify bug reproduction.
  • Hypothesis-Driven Debugging: Enforces a structured approach to generating and testing falsifiable hypotheses.
  • Use Case: When a production service reports intermittent crashes, use this Skill to build a high-frequency reproduction harness, isolate the failure, and verify the fix with a regression test.

Quick Start

Use the diagnose skill to investigate the reported performance regression in the authentication module by building a reproduction loop.

Frequently Asked Questions about diagnose

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

FAQPage Schema
What is the best way to debug complex software defects and performance regressions?

The best way to debug complex software defects is to use a systematic debugging methodology that builds deterministic feedback loops, generates falsifiable hypotheses, and verifies fixes through regression testing.

How do I troubleshoot hard-to-reproduce bugs without aimless trial and error?

To troubleshoot hard-to-reproduce bugs, construct a high-frequency reproduction harness to capture deterministic test signals, isolate the failure through hypothesis-driven predictions, and validate the resolution with regression tests.

How does hypothesis-driven debugging isolate root causes in a failing production service?

Hypothesis-driven debugging isolates root causes by enforcing a structured approach where you generate falsifiable predictions, instrument the code to test them, and rely on deterministic feedback loops to ensure technical accuracy.

Can I use systematic debugging for performance tuning and intermittent crashes?

Yes, you can use systematic debugging for performance tuning and intermittent crashes by operating across the full development lifecycle, from initial reproduction and instrumentation to final regression testing.

When should I use a structured debugging methodology instead of ad hoc troubleshooting?

You should use a structured debugging methodology when facing complex software defects that require deterministic feedback loops and clear falsifiable predictions to prevent aimless trial-and-error and ensure architectural integrity.