hunt

Diagnose software errors by testing hypotheses with targeted instrumentation and evidence.

Updated Oct 1, 2024
One-click install
npx skills add https://github.com/einargudnig/dotfiles --skill hunt-einargudnig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt
Source: https://github.com/einargudnig/dotfiles/tree/main/claude/skills/hunt
Command: npx skills add https://github.com/einargudnig/dotfiles --skill hunt-einargudnig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a disciplined diagnostic workflow to find the true root cause of errors, crashes, unexpected behavior, and failing tests before any code changes are made, preventing symptom-only patches that introduce new bugs.

Core Features & Use Cases

  • Hypothesis-first diagnosis: Require a one-sentence, testable hypothesis naming a specific file, function, or line before attempting fixes.
  • Targeted instrumentation & verification: Add the smallest possible instrument (log line, test, or assertion) to validate or falsify the hypothesis and seek independent corroborating evidence.
  • Hard rules and escalation: Stop after repeated failed hypotheses, enumerate environment differences, grep to confirm identifiers, and report a concise outcome that includes root cause, fix, and confirmation evidence.
  • Use Case: Reproduce a failing CI test, name the exact suspected file:line, add a minimal assertion or log, confirm with two independent evidence points, and only then implement and test the fix.

Quick Start

State a one-sentence, testable hypothesis identifying the exact file:line and add one targeted instrument to prove or disprove it before proposing any fix.

Frequently Asked Questions about hunt

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

FAQPage Schema
How do I find the root cause of failing tests before applying a code fix?

To find the root cause of failing tests, state a one-sentence testable hypothesis naming the exact file:line, add minimal targeted instrumentation to verify it, and gather two independent evidence points before changing code.

What is hypothesis-first debugging and how does it prevent symptom-only patches?

Hypothesis-first debugging requires naming a specific file, function, or line in a one-sentence testable hypothesis before attempting fixes, preventing symptom-only patches by forcing targeted evidence collection and verification.

How do I diagnose CI failures and environment mismatches during incident triage?

Diagnose CI failures and environment mismatches by explicitly enumerating environment differences, using grep to confirm suspected identifiers, and adding targeted assertions or logs to validate the root cause hypothesis.

What is the best way to debug crashes and rendering issues without introducing new bugs?

The best way to debug crashes and rendering issues is to apply disciplined diagnosis: add the smallest possible instrument to prove or disprove a hypothesis, confirm with independent evidence, and only then implement and test the fix.

When should I stop debugging and escalate after repeated failed hypotheses?

Stop debugging and escalate after repeated failed hypotheses by enumerating environment differences, confirming identifiers with grep, and reporting a concise outcome that names the root cause, fix, and confirmation evidence.

Can I use targeted instrumentation to reproduce a failing CI test?

Yes, you can reproduce a failing CI test by naming the exact suspected file:line, adding a minimal assertion or log as targeted instrumentation, and confirming with two independent evidence points before testing a fix.