investigation

Explains repository code behavior and rationale using session-read evidence and git history.

1|Updated Sep 10, 2026
One-click install
npx skills add https://github.com/blauwtje/exo --skill investigation-blauwtje
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: investigation
Source: https://github.com/blauwtje/exo/tree/main/skills/investigation
Command: npx skills add https://github.com/blauwtje/exo --skill investigation-blauwtje

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It prevents confident but wrong explanations of how or why code works by forcing every claim to rest on files read this session and commits traced through git history, with each claim tiered as verified, inferred, or unknown. ## Core Features & Use Cases - Three investigation modes: how walks the chain from entry to effect, why digs git blame, pickaxe, and pull requests for the reason behind a value, and teach explains both at the asker's level. - Confidence tiering: Every claim is marked verified, inferred, or unknown with its evidence anchor, so a guess is never acted on as fact. - History archaeology: Traces past renames, moves, and squash merges to the commit that actually introduced a value, including PR and issue discussion via gh. - Use Case: Ask why a retry cap is set to 50, and the skill traces the commit and pull request that set it, reports the incident that motivated it, and marks anything unproven as inferred or unknown. ## Quick Start Ask the investigation skill how the nightly sync in this repository works and where its batch size value actually comes from.

Frequently Asked Questions about investigation

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

FAQPage Schema
How do I find out why a value in code was set to a specific number?▼

Trace the value with git blame, git log --follow, and pickaxe (git log -S) to find the commit that introduced it, then read that commit's message and linked pull request. The newest commit on a line is often just a move, not the origin.

How to explain how a piece of code works before changing it?▼

Read the actual files and follow the chain from entry point to effect, including config, environment, and call-site overrides. Name the concrete function, file, and line at each hop rather than relying on names or comments.

Can git blame tell me the reason behind a line of code?▼

Git blame only shows the last commit that touched a line, which is often a rename or tidy-up, not the origin. Use git log --follow and pickaxe to trace back to the commit that actually set the value, then check its PR discussion.

When should I not use code investigation for a question?▼

Do not use it for finding file locations only, for how external libraries or APIs behave, for debugging unproven failures, or for deciding where architecture should change. Those belong to search, research, debug, or design workflows respectively.

Why is a code comment not reliable evidence of intent?▼

A comment can be added years later by a different author than the one who set the value. Check the comment's own commit date against the value's origin commit; only the commit, PR, or issue that introduced the value records the real reason.