investigate

Diagnose bugs through systematic root cause investigation before implementing fixes.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill investigate-aicodepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/agent/skills/gstack/investigate
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill investigate-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When errors, stack traces, or unexpected behavior appear, developers often jump straight to patching symptoms. This Skill enforces a disciplined four-phase debugging workflow—investigate, analyze, hypothesize, implement—so fixes address the actual root cause instead of masking the problem. ## Core Features & Use Cases - Root Cause First: Follows an iron law of no fixes without an identified root cause, guiding the AI through evidence gathering before any code change. - Proactive Triggering: Automatically activates when users report 500 errors, stack traces, regressions, or phrases like "it was working yesterday". - Session-Aware Workflow: Adapts behavior for interactive, headless, spawned, and Conductor sessions, with structured decision briefs and plan-mode safety gates. - Use Case: A user reports that their app started returning 500 errors after a deploy. The Skill walks through log inspection, hypothesis formation, and verification before any fix is applied. ## Quick Start Ask the assistant to investigate why the application is throwing an 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?

Invoke the investigate skill when you encounter an error or unexpected behavior. It guides the AI through four phases—investigate, analyze, hypothesize, implement—and blocks any code 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 stack traces, 500 errors, regressions, or reports that something stopped working. Direct fixes often patch symptoms; the investigation workflow ensures the underlying cause is found so the bug does not recur.

Does the investigate skill work in headless or CI sessions?

Yes, the skill detects the session kind via its preamble. In headless sessions it blocks on unavailable user questions, in spawned sessions it auto-chooses recommended options, and in interactive sessions it uses structured decision briefs.

What happens if AskUserQuestion is unavailable during debugging?

The skill falls back based on session type: headless sessions stop with a BLOCKED status, interactive sessions render the decision brief as prose with completeness scores and a recommendation, and spawned sessions auto-select the recommended option.

Can the investigate skill make code changes in plan mode?

In plan mode only safe read-only operations and writes to designated state directories are allowed. The skill treats its workflow as executable instructions and only exits plan mode after the investigation workflow completes or the user cancels.