investigate-first

Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.

29K installs 103K starsUpdated Sep 2, 2026License: No license file

Install

npx skills add JuliusBrussee/caveman@investigate-first

Runs in your terminal. Adds the skill globally for Claude Code, Cursor, Codex and others; add -g -y to skip prompts.

What it does

Investigate first Gather evidence before changing product code. - Separate observed symptom from inferred cause. - Trace inputs, state transitions, ownership boundaries, and failure output. - Rank hypotheses by evidence and cheap falsification value. - Do not edit until one credible mechanism explains evidence. - Stop exploration when evidence is sufficient to name cause or exact blocker. Report cause and proof. Make no fix unless task authorizes implementation.

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

View source on GitHub

Before you install

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Related skills

caveman
JuliusBrussee/caveman
>
476K installs 103K
caveman-commit
JuliusBrussee/caveman
>
334K installs 103KTestingDeploy & DevOpsDocumentation
caveman-review
JuliusBrussee/caveman
>
331K installs 103KCode review
caveman-compress
JuliusBrussee/caveman
>
329K installs 103KDataAI & agents
caveman-help
JuliusBrussee/caveman
>
322K installs 103K
cavecrew
JuliusBrussee/caveman
>
280K installs 103KAI & agentsCode reviewGit & GitHub

← Search skills