One-click install
npx skills add https://github.com/docs-plus/docs.plus --skill diagnose-docs-plus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/docs-plus/docs.plus/tree/main/.agents/skills/diagnose
Command: npx skills add https://github.com/docs-plus/docs.plus --skill diagnose-docs-plus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill eliminates unproductive, ad-hoc debugging for complex, hard-to-reproduce bugs and performance regressions that waste engineering time and often lead to incomplete, recurring fixes.

Core Features & Use Cases

  • 6-Phase Disciplined Debug Loop: Follow a structured workflow of building a feedback loop, reproducing the bug, generating falsifiable hypotheses, targeted instrumentation, fixing with regression tests, and post-mortem cleanup to ensure thorough, repeatable debugging.
  • Reproduction Loop Guidance: Provides 10 prioritized methods to build fast, deterministic, agent-runnable reproduction loops, including failing tests, headless browser scripts, and bisection harnesses, even for non-deterministic or flaky bugs.
  • Use Case: For example, if a team is investigating a performance regression that only occurs under high concurrent load, this skill guides them to build a load test reproduction loop, rank hypotheses about database query bottlenecks or cache misses, instrument only the relevant code paths, and add a regression test to prevent the issue from recurring.

Quick Start

Use the diagnose skill to debug the intermittent 500 error that occurs when uploading large files to the production API.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I debug hard-to-reproduce software bugs and performance regressions efficiently?

Debug hard-to-reproduce software bugs efficiently by following a structured 6-phase disciplined workflow that builds deterministic reproduction loops, generates falsifiable hypotheses, and adds regression tests to ensure durable fixes.

What is the best way to create a reproduction loop for flaky test failures?

The best way to create a reproduction loop for flaky test failures is using prioritized methods like failing tests, headless browser scripts, and bisection harnesses to build fast, deterministic, agent-runnable loops.

How does falsifiable hypothesis testing work for root cause analysis?

Falsifiable hypothesis testing for root cause analysis works by generating targeted assumptions about defect sources, instrumenting specific code paths, and validating or rejecting hypotheses within a structured debug loop.

Can I use this disciplined workflow for post-deployment production incidents?

Yes, you can use this disciplined workflow for post-deployment production incidents, as it applies to software engineering workflows including opaque defect reports, intermittent errors, and performance regressions under specific load conditions.

Why do incomplete bug fixes keep recurring despite patching the obvious error?

Incomplete bug fixes keep recurring because ad-hoc debugging often misses the root cause, whereas a disciplined workflow enforces hypothesis generation, targeted instrumentation, and regression test implementation to prevent recurrence.

Does this debugging approach require existing test infrastructure to investigate performance regressions?

No, this debugging approach does not strictly require existing test infrastructure, as it provides guidance to build load test reproduction loops and bisection harnesses from scratch for investigating performance regressions under high concurrent load.