investigate

Guide a four-phase workflow to identify root causes of errors and regressions.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/sanskarbasnet/fstack --skill investigate-sanskarbasnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/sanskarbasnet/fstack/tree/main/investigate
Command: npx skills add https://github.com/sanskarbasnet/fstack --skill investigate-sanskarbasnet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging with root cause investigation, guiding a four-phase workflow to identify underlying causes before applying fixes.

Core Features & Use Cases

  • Four-phase debugging workflow: investigate, analyze, hypothesize, implement.
  • Proactive guidance with strict gating to avoid blind patching and noise.
  • Tool integration: Bash, Read, Write, Edit, Grep, Glob, and AskUserQuestion for data gathering and decision making.
  • Use case: when users report errors, stack traces, or "it was working yesterday" scenarios, to identify root cause.

Quick Start

Say "investigate this error" to begin the four-phase 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 find the root cause of a stack trace before applying a fix?

A systematic root-cause debugging workflow prevents blind patching by gating fixes behind four phases: investigate, analyze, hypothesize, and implement. This ensures you gather data and verify underlying causes before modifying code.

What is the best way to troubleshoot unexpected behavior across my codebase?

Troubleshooting unexpected behavior across a codebase requires inspecting artifacts using Bash, Grep, and Glob. A four-phase debugging workflow proactively gathers data and queries decisions to identify the exact root cause of regressions.

How do I debug performance regressions without introducing noise?

Debugging performance regressions without noise requires strict gating to avoid blind patching. A systematic workflow inspects service artifacts and queries decisions interactively, ensuring fixes target verified underlying causes rather than symptoms.

Does this debugging workflow work for errors in service integrations?

Yes, this systematic debugging workflow applies to errors, stack traces, and unexpected behavior across codebases, services, or integrations. It uses environment tools like Bash and Grep to inspect artifacts and query decisions.

How do I start a systematic root-cause analysis session?

To start a systematic root-cause analysis session, trigger the workflow with a command like "investigate this error." This initiates the four-phase process to gather data, analyze artifacts, and form hypotheses for fixes.