investigate

Diagnose software issue root causes through structured evidence-gathering phases.

Updated May 11, 2026
One-click install
npx skills add https://github.com/wodeh/gstack-kimi --skill investigate-wodeh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/wodeh/gstack-kimi/tree/main/investigate
Command: npx skills add https://github.com/wodeh/gstack-kimi --skill investigate-wodeh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging with root cause investigation enables teams to identify the true cause of issues rather than applying quick fixes. It guides responders through a repeatable, phase-driven workflow to move from observation to root-cause resolution.

Core Features & Use Cases

  • Phase-driven process: investigate, analyze, hypothesize, and implement to structure problem solving.
  • Evidence gathering and hypothesis testing using deterministic tooling (Bash, Read, Write, Edit, Grep, Glob, WebSearch).
  • Use Case: when a bug or unexpected behavior occurs, run the four phases to locate the root cause and propose sustainable fixes.

Quick Start

To begin, say 'investigate this issue' to start the root-cause analysis workflow.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I find the root cause of a software bug instead of just patching symptoms?

Root-cause debugging uses a structured workflow to collect evidence and trace fault paths, moving from observation to resolution. It structures problem-solving into investigate, analyze, hypothesize, and implement phases to locate true underlying causes.

What's the best way to debug flaky behavior across code and deployments?

Debugging flaky behavior requires gathering evidence using deterministic tooling like Bash probes and Grep to trace fault paths across code and configurations. A structured investigation workflow guides responders through systematic hypothesis testing to diagnose intermittent issues.

Can I use Bash commands to gather evidence during a root-cause analysis?

Yes, Bash-based probes are used to gather evidence and test hypotheses during root-cause analysis. The workflow supports deterministic tooling including Bash, Read, Write, Edit, Grep, and Glob to safely collect data and trace faults.

How do I start an investigation when an unexpected error occurs in my deployment?

Start an investigation by initiating the root-cause analysis workflow to collect evidence and trace fault paths. The process moves through structured phases of investigation, analysis, hypothesis testing, and implementation to guide responders from observation to resolution.

Does web search help corroborate debugging hypotheses during root-cause analysis?

Yes, optional web searches can corroborate hypotheses during root-cause analysis. Alongside deterministic tooling like Bash probes and file operations, web searches help verify findings when tracing fault paths and diagnosing complex software issues across deployments.

When should I use a structured debugging workflow for software issues?

Use a structured debugging workflow when bugs, errors, or flaky behavior occur and require true root-cause identification rather than quick fixes. It is applicable across code, deployments, and configurations where systematic evidence collection and hypothesis testing are needed.