investigate

Guide users through a four-phase root-cause investigation before implementing fixes.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/antriksh-29/reddit-automation --skill investigate-antriksh-29
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/antriksh-29/reddit-automation/tree/main/.claude/skills/gstack/investigate
Command: npx skills add https://github.com/antriksh-29/reddit-automation --skill investigate-antriksh-29

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MANUAL TRIGGER ONLY: invoke only when user types /investigate. 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, unexpected behavior, or is troubleshooting why something stopped working.

Core Features & Use Cases

  • Four-phase root-cause investigation: investigate, analyze, hypothesize, implement.
  • Manual trigger only: invoked by explicit user action.
  • Proactive guidance: suggests potential causes and next steps when users report issues.
  • Tool integration: supports Bash, Read, Write, Edit, Grep, Glob, AskUserQuestion, WebSearch to gather evidence and explore solutions.

Quick Start

Invoke the investigate workflow to start a four-phase root-cause debugging process when the user asks to debug something.

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 bug in my software workflow?

To find the root cause of a bug, you need a structured debugging workflow that gathers evidence using tools like Bash, Read, and Grep before attempting any fixes. This approach enforces a four-phase investigation to verify the underlying issue.

What is the best way to debug unexpected errors without guessing the fix?

The best way to debug unexpected errors without guessing is to follow a disciplined root-cause analysis process. This involves investigating, analyzing, hypothesizing, and implementing, ensuring no code fixes are applied until the root cause is verified.

Can I use a structured investigation to troubleshoot failing systems?

Yes, you can use a structured investigation to troubleshoot failing systems by applying a four-phase root-cause analysis. It guides you through evidence gathering with tools like WebSearch and Glob to identify why a system stopped working.

When should I use a root-cause analysis workflow for debugging?

You should use a root-cause analysis workflow when you report errors, experience unexpected behavior, or need to investigate why a software system is broken. It provides proactive guidance and suggests potential causes for complex issues.

Does this debugging approach support searching for external solutions?

Yes, this debugging approach supports searching for external solutions by integrating WebSearch alongside file reading and editing tools. This allows you to gather evidence and explore potential fixes during the hypothesis phase.