investigate

Diagnose bugs through systematic root cause investigation before applying fixes.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill investigate-abdulazeezoj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/investigate
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill investigate-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging under pressure often leads to guess-and-check fixes that mask symptoms instead of resolving the underlying defect. This Skill enforces a disciplined four-phase workflow (investigate, analyze, hypothesize, implement) with an iron law: no fixes without an identified root cause. ## Core Features & Use Cases - Structured Root Cause Analysis: Walks through investigation, analysis, hypothesis formation, and implementation phases so fixes target the actual defect. - Proactive Error Handling: Activates when users report 500 errors, stack traces, unexpected behavior, or regressions like "it was working yesterday". - Scope Guardrails: PreToolUse hooks check a debug scope boundary before edits or writes, keeping investigation changes contained. - Context Recall: Pulls prior investigations, project learnings, and past eureka moments from local gstack artifacts to avoid re-solving known problems. - Use Case: A user reports a production 500 error after a deploy. The Skill gathers evidence, forms and tests hypotheses against logs and code, identifies the root cause, and only then implements a verified fix. ## Quick Start Ask the assistant to investigate why the login endpoint returns a 500 error and find the root cause before fixing it.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I debug a bug with root cause analysis instead of guessing?

Invoke the investigate skill when you hit an error, stack trace, or regression. It walks through four phases—investigate, analyze, hypothesize, implement—and blocks any fix until the root cause is identified and verified.

When should I use a systematic debugging workflow instead of fixing directly?

Use it whenever you see 500 errors, unexpected behavior, or "it worked yesterday" regressions. Direct fixes without root cause analysis often mask symptoms and let the defect resurface elsewhere.

Does the investigate skill work in automated or headless sessions?

Yes. It detects spawned, headless, and interactive session kinds from its preamble and adapts: spawned sessions auto-choose recommended options, headless sessions block on missing input, and interactive sessions ask the user.

What happens if the skill's setup scripts are missing or stale?

It enters degraded mode with safe defaults: treats the session as interactive, skips onboarding and telemetry gates, and tells you to run ./setup or /gstack-upgrade while continuing your debugging task.

Can the investigate skill edit files outside the debug scope?

No. PreToolUse hooks run a freeze check before every Edit or Write call to enforce the debug scope boundary, preventing changes outside the approved investigation area.