investigate

Diagnose bugs through systematic root cause investigation before applying fixes.

Updated May 22, 2026
One-click install
npx skills add https://github.com/kitfunso/claude-config --skill investigate-kitfunso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/kitfunso/claude-config/tree/main/skills/investigate
Command: npx skills add https://github.com/kitfunso/claude-config --skill investigate-kitfunso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a bug, error, or wrong result appears, the temptation is to patch the symptom at the crash site. This Skill enforces a disciplined four-phase debugging workflow — investigate, analyze, hypothesize, implement — with an iron law: no fixes without an identified root cause. ## Core Features & Use Cases - Root Cause Enforcement: Traces errors back through callers and shared helpers so fixes land at the true source, not just the file that crashed. - Shared-Impact Analysis: Identifies other call sites affected by the same defect, preventing partial fixes that leave sibling code broken. - Not-a-Bug Detection: Pushes back on incorrect bug framings when the code is actually correct and the output reflects real data. - Use Case: A script crashes with ValueError: could not convert string to float: '1,234.5'. Instead of patching the crashing file, the Skill traces the failure to a shared to_float() helper, flags every caller that shares the bug, and fixes the helper itself. ## Quick Start Ask the AI to debug this error and find the root cause before fixing anything.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I debug an error without just patching the symptom?▼

Trace the failure back through the call chain to the shared function where the bad behavior originates, then fix it there. This Skill enforces that workflow: investigate, analyze, hypothesize, and only then implement, so callers sharing the same defect are fixed too.

What is root cause analysis for software bugs?▼

Root cause analysis identifies the underlying defect responsible for a failure rather than the location where it surfaced. For example, a crash in one script may stem from a shared parsing helper, and fixing only the crash site leaves other callers broken.

Can this Skill tell when something is not actually a bug?▼

Yes. It verifies the reported behavior against the actual code and data before changing anything. If the output is correct given the inputs — such as a negative margin reflecting a genuine loss — it rejects the bug framing instead of inventing a fix.

When should I invoke the investigate skill?▼

Invoke it when you see errors, stack traces, 500 responses, unexpected behavior, or phrases like "it was working yesterday". It is designed for any situation where something stopped working and the cause is not yet known.

Why does fixing only the crashing file leave other bugs behind?▼

Multiple call sites often share the same helper function, so the defect lives in the helper, not the caller. Patching one caller leaves every other caller exposed to the same failure under the same inputs.