personal-investigate

Diagnose and verify root causes of bugs before applying minimal fixes.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/kosako/agent-tools --skill personal-investigate-kosako
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: personal-investigate
Source: https://github.com/kosako/agent-tools/tree/main/shared/skills/personal-investigate
Command: npx skills add https://github.com/kosako/agent-tools --skill personal-investigate-kosako

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents the common debugging failure of patching symptoms with guesswork fixes by enforcing a strict rule: no fix without a verified root cause, so bugs stop recurring after repeated failed patches. ## Core Features & Use Cases - Root-cause-first workflow: An eight-phase process covering symptom collection, reverse code tracing, recent-change review via git, reproduction, testable hypothesis, verification, minimal fix, and structured reporting. - Fix authorization gate: Distinguishes diagnose-only mode (read-only investigation, default for ambiguous reports) from fix-authorized mode (explicit fix intent or verified scoped continuation), so it never modifies files without permission. - 3-strike rule: After three failed hypotheses or unverified patch attempts, it stops stacking patches and re-examines assumptions or architecture instead. - Use Case: When a user reports "this test is flaky, debug it", the skill gathers the exact error, reproduces the failure, checks recent git history, verifies a concrete root cause hypothesis, and reports evidence before any code change. ## Quick Start Ask the AI to investigate why a specific bug or error occurs and verify the root cause before fixing it.

Frequently Asked Questions about personal-investigate

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

FAQPage Schema
How do I debug a bug without guessing at fixes?▼

Follow a root-cause-first process: collect exact error messages and reproduction steps, trace the code path backward, check recent git changes, form one testable hypothesis, and verify it with logs or tests before editing any code.

How to investigate a flaky test that fails intermittently?▼

Capture the original stack trace and the conditions under which it fails versus passes, then use git log to narrow when instability began. Do not patch until the failure reproduces deterministically and the cause is verified.

What is the difference between diagnose-only and fix-authorized mode?▼

Diagnose-only is the default for requests like "find the cause": it performs read-only investigation and reports the verified root cause with evidence, then stops. Fix-authorized requires an explicit fix request and proceeds to a minimal fix only after verification.

What should I do after three failed fix attempts on the same bug?▼

Stop applying patches in the same layer. The 3-strike rule treats failed guesses as a signal that the framing or architecture assumption is wrong, so revisit the investigation approach or consult another perspective instead.

When should this debugging skill not be used?▼

It is not intended for general feature implementation or repository-wide audits, which belong to separate workflows. It also never writes to memory or external knowledge stores without explicit user authorization.