diagnose

Diagnose hard bugs and performance regressions through a structured six-phase workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce, minimise, hypothesise, instrument, fix, and regression-test in a repeatable process.

Core Features & Use Cases

  • Structured six-phase workflow guiding reproducibility, hypothesis testing, instrumentation, fixes, and verification.
  • Helps engineers triage failures, flaky tests, and performance regressions with guardrails and repeatable evidence.
  • Use case: when a user reports a bug or slowdown, follow Phase 1 to build a reliable reproduction and a plan for fixing.

Quick Start

Build a deterministic reproduction loop for the reported bug and start Phase 1.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I debug a hard bug that is difficult to reproduce?

Debug a hard bug by building a deterministic reproduction loop, then follow a structured workflow to minimize the case, test explicit hypotheses, and apply safe instrumentation to isolate the root cause.

What is the best way to diagnose a performance regression in my code?

To diagnose a performance regression, apply a disciplined phase-based workflow that establishes reproducibility, forms hypotheses, adds instrumentation to measure slowdowns, and verifies the fix with regression tests.

How do I systematically find the root-cause of a flaky test?

Find the root-cause of a flaky test by executing a repeatable diagnosis loop that triages the failure, establishes a reliable reproduction, tests defined hypotheses, and instruments the code for deterministic evidence.

Can I use a structured debugging workflow for any codebase?

Yes, this structured debugging workflow applies across codebases when users report defects or describe slowdowns, guiding reproducibility, hypotheses, instrumentation, and fixes to ensure deterministic and testable outcomes.

Why should I use explicit hypotheses when diagnosing a bug?

Explicit hypotheses prevent blind changes during bug diagnosis by forcing you to define expected outcomes before instrumenting, ensuring you gather repeatable evidence and apply fixes that produce deterministic, testable results.