hypothesis-generation

Identify root causes of software, system, and process errors via structured hypotheses and tests.

34|7|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/jkitchin/skillz --skill hypothesis-generation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hypothesis-generation
Source: https://github.com/jkitchin/skillz/tree/main/skills/technical/troubleshooting/references/hypothesis-generation.md
Command: npx skills add https://github.com/jkitchin/skillz --skill hypothesis-generation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured approach to hypothesize, rank, and test potential causes during troubleshooting.

Core Features & Use Cases

  • Hypothesis Formulation: testable via the structure “If X is true, then Y should occur.”
  • Ranking & Testing: prioritize by likelihood and evidence strength; design tests that are quick and reversible.
  • Test Design: concrete steps for validating or falsifying hypotheses.

Quick Start

Propose 3 plausible causes for a failure, rank by likelihood, and design 1 concrete test per hypothesis.

Frequently Asked Questions about hypothesis-generation

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

FAQPage Schema
How do I diagnose root causes of software errors and failures?

Root cause diagnosis uses a structured form-test-refute loop: formulate testable hypotheses as "if X then Y" statements, rank by likelihood, design concrete tests to validate or falsify each, and document findings. This repeatable workflow identifies underlying causes across code, configuration, infrastructure, and processes.

What's the best way to design tests for debugging intermittent issues?

Test design prioritizes quick, reversible validation steps. Propose 3 plausible causes, rank by evidence strength, then design one concrete test per hypothesis that can confirm or rule out each cause without disrupting production or leaving side effects.

How do I structure a diagnostic workflow for production troubleshooting?

A diagnostic workflow follows eight phases: Understand the failure, Gather logs and context, Hypothesize root causes, Design tests, Test hypotheses, Identify the true cause, Verify the fix, and Document results. This auditable process scales across development, QA, and production environments.

Can I use the 5-whys technique with hypothesis ranking for faster debugging?

Yes. Combine 5-whys exploration with evidence-based ranking to narrow suspects quickly. Formulate each layer as a testable hypothesis, prioritize by likelihood, then design tests for the highest-confidence candidates first to resolve failures efficiently.

What types of failures does hypothesis-driven diagnosis cover?

Hypothesis-driven diagnosis addresses errors, wrong outputs, performance degradation, intermittent issues, and process failures across software code, configuration, infrastructure, and business processes. It works in development, QA, and production with tool-assisted analysis like log analysis and reproduction case generation.