diagnose

Diagnose software failures by constructing reproducible test cases and evidence bundles.

Updated May 8, 2026
One-click install
npx skills add https://github.com/ace3/skills --skill diagnose-ace3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/ace3/skills/tree/main/skills/diagnose
Command: npx skills add https://github.com/ace3/skills --skill diagnose-ace3

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Disciplined diagnosis for hard bugs, failing tests, broken runtime behavior, flaky failures, unclear root causes, and performance regressions. It helps teams avoid guesswork by guiding evidence-backed analysis and providing structured handoffs to backend-developer, frontend-developer, or qa.

Core Features & Use Cases

  • Evidence-driven diagnosis that captures symptoms, environment, logs, and artifacts to build testable hypotheses.
  • Structured handoffs specifying ownership to the correct developer skill and a defined output contract.
  • Standardized output guidance with Findings, Plan, and Routing bundles to accelerate reviews and remediation.

Quick Start

Start by describing a reproducible failure and request a Diagnosis Report to generate a proven root-cause analysis and handoff plan.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I diagnose the root cause of flaky test failures and broken runtime behavior?

To diagnose the root cause of flaky test failures, this skill constructs a reproducible test case from symptoms, logs, and environmental context to generate ranked hypotheses, a proven root cause, and remediation steps within a structured Findings Bundle.

What is the best way to perform evidence-driven root cause analysis for software regressions?

The best way to perform evidence-driven root cause analysis for software regressions is to assess symptom signals and recent changes within a structured diagnosis loop, producing a Findings Bundle with evidence, ranked hypotheses, and a defined handoff to developer skills.

How do I create a structured handoff for reported software bugs to assign ownership to developers?

You create a structured handoff for reported software bugs by generating a Findings Bundle that specifies routing to the appropriate developer skill, including proven root cause analysis, remediation steps, and regression checks to accelerate reviews.

Can I use this diagnosis approach for unclear software bugs without guessing at the solution?

Yes, you can use this diagnosis approach for unclear software bugs because it avoids guesswork by guiding evidence-backed analysis, collecting artifacts, and forming testable hypotheses before outputting a defined remediation plan.

What do I need to provide to generate a diagnosis report for a failing test?

To generate a diagnosis report for a failing test, you need to provide a description of a reproducible failure, which the skill uses to capture symptom signals, environmental context, and recent changes to output a proven root-cause analysis.

When should I use a structured diagnosis loop instead of standard debugging?

You should use a structured diagnosis loop instead of standard debugging for hard bugs, performance regressions, and flaky failures, as it builds testable hypotheses and provides standardized output guidance with Findings, Plan, and Routing bundles for remediation.