investigate

Identify root causes of software bugs using logs and system tools.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Faeif/linguaquest --skill investigate-faeif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/Faeif/linguaquest/tree/main/.claude/skills/gstack/investigate
Command: npx skills add https://github.com/Faeif/linguaquest --skill investigate-faeif

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.

Core Features & Use Cases

  • Four-phase debugging workflow (investigate, analyze, hypothesize, implement)
  • Proactive invocation when users report errors, 500 errors, stack traces, or unexpected behavior
  • Tool integration: Bash, Read, Write, Edit, Grep, Glob, AskUserQuestion, WebSearch
  • Use case: when a user reports it's broken, guide diagnosis and plan fixes

Quick Start

Describe the failing symptoms and gather logs to initiate root-cause analysis.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I identify the root cause of a 500 error or stack trace?

To identify the root cause of a 500 error or stack trace, systematically gather logs and evidence using a four-phase workflow: investigate, analyze, hypothesize, and implement. This ensures no fixes are applied without understanding the underlying error.

What is the best way to stop recurring software bugs across modules and services?

The best way to stop recurring bugs across modules and services is enforcing an iron law of no fixes without root cause analysis. By systematically investigating symptoms and gathering evidence before proposing changes, you prevent superficial patches.

How do I start debugging unexpected behavior when a user reports a system is broken?

To start debugging unexpected behavior, describe the failing symptoms and gather logs to initiate root-cause analysis. The investigation phase proactively coordinates end-to-end checks to collect the necessary evidence for a hypothesis.

Can I use this debugging workflow for errors spanning multiple services?

Yes, you can use this workflow for errors spanning multiple services. It applies to unexpected behavior across modules and services, satisfying end-to-end coordination and explicit checks to safely gather evidence and propose fixes.

What tools are integrated into the root-cause analysis process?

The root-cause analysis process integrates Bash, Read, Write, Edit, Grep, Glob, AskUserQuestion, and WebSearch. These tools gather evidence, inspect system files, and search for context to accurately identify and propose fixes for bugs.