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.