investigate

Investigate software defect root causes through a four-phase evidence-gathering workflow.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/CaltexBevo/ihe-pulse --skill investigate-caltexbevo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/CaltexBevo/ihe-pulse/tree/main/.claude/skills/gstack.bak/investigate
Command: npx skills add https://github.com/CaltexBevo/ihe-pulse --skill investigate-caltexbevo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging with root-cause investigation. Four phases: investigate, analyze, hypothesize, implement. Iron Law: no fixes without root cause. Use when asked to "debug this", "fix this bug", "why is this broken", "investigate this error", or "root cause analysis". Proactively suggest when the user reports errors or unexpected behavior, or troubleshooting why something stopped working.

Core Features & Use Cases

  • Four-phase workflow: investigate, analyze, hypothesize, implement to uncover root causes.
  • Proactive guidance: flags potential issues and suggests next steps when user reports errors.
  • Tooling integration: leverages Bash, Read, Write, Edit, Grep, Glob, AskUserQuestion, WebSearch to gather evidence and test hypotheses.

Quick Start

Describe the error, provide reproduction steps, and I will start the root-cause investigation.

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?

Debugging a regression requires a four-phase workflow: investigate the symptom using bash and grep, analyze the gathered evidence, hypothesize the root cause, and implement the verified fix to ensure the regression does not repeat.

Can I use bash and grep to investigate unexpected application errors?

Yes, you can use bash and grep to investigate unexpected application errors by searching codebases, reading log files, and collecting evidence to systematically triage the anomaly and verify the root cause before applying any code changes.

What is the best way to triage a performance anomaly?

The best way to triage a performance anomaly is to execute a structured investigation workflow that requires explicit reproduction steps, gathers evidence using file search and web search, and verifies the root cause before proposing a targeted fix.

Why should I verify a root cause before implementing a bug fix?

Verifying a root cause before implementing a bug fix enforces the iron law of debugging, ensuring you address the actual underlying issue with evidence rather than applying a superficial patch that leaves the defect ready to repeat.

Does root-cause debugging work without explicit reproduction steps?

Root-cause debugging requires explicit reproduction steps to effectively identify and verify the source of software defects. Without these steps, the investigation cannot reliably gather evidence or confirm the hypothesis before implementing a fix.