diagnose

Run a six-step diagnosis loop with evidence gates for reproducible failures.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a disciplined, evidence-gated debugging loop that ensures failures are diagnosed with repeatable, artifact-backed steps.

Core Features & Use Cases

  • Structured six-step loop: Reproduce → minimise → hypothesise → instrument → fix → regression-test with strict gates between stages.
  • Evidence-driven progression: Each step requires a concrete artifact before advancing to the next.
  • Use cases: Ideal for reproducible failures in production services and complex fault isolation across systems.

Quick Start

Run a disciplined six-step diagnosis loop on a reproducible failure, enforcing evidence gates before advancing through each step.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I structure a debugging workflow for complex production system failures?

A structured debugging workflow enforces a six-step loop: reproduce, minimise, hypothesise, instrument, fix, and regression-test. Strict gates between each stage require concrete artifacts before advancing, ensuring complex production failures are isolated through repeatable steps.

What is evidence-driven debugging and how does it validate root-cause hypotheses?

Evidence-driven debugging validates root-cause hypotheses by requiring instrumented checks and concrete artifacts at each stage. This disciplined approach ensures fault isolation is backed by repeatable, artifact-backed steps rather than assumptions, preventing premature conclusions in complex systems.

How do I create a minimal reproducer for intermittent production service failures?

Creating a minimal reproducer requires capturing the production environment and isolating the specific conditions triggering the failure. This reproducible failure analysis serves as a gate-kept artifact, ensuring the diagnostic loop progresses only with validated reproductions.

Can I use this disciplined diagnosis loop for fault isolation across distributed systems?

Yes, this disciplined diagnosis loop applies to complex fault isolation scenarios across distributed production-grade systems. It requires environment capture, a minimal reproducer, and instrumented checks to validate hypotheses across systems before advancing through gate-enforced diagnostic stages.

What prerequisites do I need before starting gate-enforced debugging on a reproducible failure?

Gate-enforced debugging requires a reproducible failure, complete environment capture, and a minimal reproducer as prerequisites. These artifacts must be collected before entering the structured diagnosis loop, ensuring complex fault isolation begins with validated, instrumented inputs.