investigate

Diagnose software issues through a structured root-cause debugging workflow.

5|2|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/agatx/serenada --skill investigate-agatx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/agatx/serenada/tree/main/.claude/skills/gstack/investigate
Command: npx skills add https://github.com/agatx/serenada --skill investigate-agatx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a disciplined, root-cause debugging workflow to diagnose and fix issues by following a four-phase process: investigate, analyze, hypothesize, implement.

Core Features & Use Cases

  • Structured workflow: enforces a repeatable path from problem discovery to solution validation.
  • Phase-driven reasoning: guides hypothesis formation, evidence gathering, and targeted fixes.
  • Use Case: when a user encounters an error in a script or service, this skill helps navigate from initial symptoms to a verified root cause.

Quick Start

Describe the issue you are seeing and ask me to begin a root-cause investigation.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I perform root-cause debugging for a crashing bash script?

Root-cause debugging for a crashing bash script requires a structured workflow that investigates symptoms, analyzes code, forms hypotheses, and implements verified fixes. This approach enforces a repeatable path from problem discovery to solution validation.

What is the best way to troubleshoot unexpected software errors using grep and logs?

Troubleshooting unexpected software errors using grep and logs is best handled by a disciplined investigation workflow. It guides evidence gathering and hypothesis formation to navigate from initial symptoms to a verified root cause.

How do I systematically analyze symptoms and fix bugs in my services?

To systematically analyze symptoms and fix bugs in services, apply a phase-driven reasoning process. This method bounds debugging sessions with a freeze check to ensure targeted fixes and reproducible investigations.

What do I need to start a root-cause investigation for application errors?

To start a root-cause investigation for application errors, you need an available error report or symptoms, and access to relevant code or logs. This allows the workflow to reason through steps using Bash, Read, Grep, and Edit.

When should I use a structured debugging workflow instead of ad-hoc troubleshooting?

You should use a structured debugging workflow instead of ad-hoc troubleshooting when you encounter errors, crashes, or unexpected behavior in scripts, services, or applications. It ensures reproducible investigations and verified fixes.