investigate

Guide evidence-based root cause investigation for codebase errors and unexpected behavior.

37|7|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/unclejobs-ai/second-claude-code --skill investigate-unclejobs-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/unclejobs-ai/second-claude-code/tree/main/skills/investigate
Command: npx skills add https://github.com/unclejobs-ai/second-claude-code --skill investigate-unclejobs-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of resolving errors and unexpected behavior by forcing an evidence-first root-cause investigation instead of guess-driven fixes.

Core Features & Use Cases

  • Evidence gathering first: Extract the exact error, reproduction conditions, and relevant recent changes before forming opinions.
  • Pattern-based classification: Map symptoms to common failure modes such as race conditions, state corruption, dependency conflicts, and schema drift.
  • Hypothesize and test safely: Make explicit hypotheses, run minimal tests, and stop after repeated incorrect hypotheses to request more context.
  • Verified fixes with regression tests: Apply the minimal fix only after root cause confirmation, then immediately add and run a regression test.

Quick Start

Use the investigate skill to debug a failing stack trace by gathering evidence, classifying the likely pattern, testing explicit hypotheses, and producing a verified regression-tested fix.

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 an intermittent failure using a stack trace?

To find the root cause of an intermittent failure, gather exact error evidence and reproduction conditions first, then classify symptoms against common patterns like race conditions or state corruption before testing explicit hypotheses.

What is the best way to debug configuration drift and schema mismatches across related modules?

The best way to debug configuration drift and schema mismatches is through evidence-first investigation, mapping the observed symptoms to common failure modes and testing explicit hypotheses with minimal scope before applying fixes.

How do I troubleshoot dependency conflicts without guessing?

Troubleshoot dependency conflicts by extracting recent changes and exact reproduction conditions, classifying the failure pattern, and verifying a minimal-scope fix only after confirming the root cause through targeted hypothesis testing.

When should I stop forming new hypotheses during incident response debugging?

During incident response debugging, you should stop forming new hypotheses after repeated incorrect tests and request more context, ensuring fixes are applied only after the root cause is explicitly confirmed.

How do I prevent regressions when fixing routing mismatches in my codebase?

Prevent regressions when fixing routing mismatches by applying the minimal fix immediately after root cause confirmation, then creating and running an explicit regression test to verify the resolution.

Can I use evidence-based investigation for dependency conflicts and state corruption?

Yes, evidence-based investigation applies to dependency conflicts and state corruption by enforcing pattern-based classification and safe hypothesis testing, ensuring fixes target the verified root cause rather than guesses.