diagnose

Diagnose hard bugs and performance regressions through a structured reproduction and testing loop.

1|Updated Aug 12, 2023
One-click install
npx skills add https://github.com/nktfh100/nixos-config --skill diagnose-nktfh100
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/nktfh100/nixos-config/tree/main/claude/skills/diagnose
Command: npx skills add https://github.com/nktfh100/nixos-config --skill diagnose-nktfh100

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

A disciplined, end-to-end debugging loop that reduces time-to-resolution for hard bugs and performance regressions by guiding structured reproduction, hypothesis generation, instrumentation, and regression testing.

Core Features & Use Cases

  • Reproduce bugs deterministically using a structured workflow.
  • Generate and rank hypotheses before testing.
  • Instrument code paths and collect targeted signals to validate predictions.
  • Conduct regression tests to ensure fixes hold across releases.
  • Suitable for reports of crashes, hangs, or slowdowns in complex systems.

Quick Start

Apply the six-phase diagnose loop to reproduce, hypothesise, instrument, and verify a fix.

Frequently Asked Questions about diagnose

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

FAQPage Schema
What is a structured debugging loop for resolving hard bugs and performance regressions?▼

A structured debugging loop is a disciplined workflow that reduces time-to-resolution for hard bugs by guiding deterministic reproduction, hypothesis generation, instrumentation, and regression testing.

How do I reproduce crashes and slowdowns deterministically during diagnosis?▼

You reproduce crashes and slowdowns deterministically by applying a structured workflow that isolates triggers, instruments targeted code paths, and collects signals to validate bug reproduction.

What's the best way to generate and rank hypotheses when debugging complex system hangs?▼

The best way to debug complex system hangs is using a disciplined diagnosis loop that generates and ranks hypotheses before testing them against targeted instrumentation signals.

How do I conduct regression testing to ensure bug fixes hold across releases?▼

You conduct regression testing by running test harnesses after applying a fix, verifying that the deterministic reproduction case fails safely and the fix holds without introducing new crashes.

Do I need test harnesses and instrumentation strategies to diagnose hard bugs?▼

Yes, diagnosing hard bugs requires test harnesses, instrumentation strategies, and clear rollback procedures to ensure deterministic diagnostics and validate hypothesis predictions accurately.