What is the difference between this and hypothesis testing?

Hypothesis testing checks a specific claim; Guided Investigation helps you discover what the claims should be by exploring data patterns systematically.

Does this skill require pre-processed data?

Yes, it requires data to be imported into a SQLite database and cleaned using the datapeeker importing and cleaning skills before starting.

When should I use the Guided Investigation skill?

Use it for open-ended questions where you lack a specific hypothesis, such as 'What is causing this trend?' or 'Why are we seeing these results?'

How does it help prevent unfocused analysis?

It enforces a decomposition phase where broad questions must be broken into 3-5 specific, answerable sub-questions before any querying begins.

Guided Investigation Framework

Name: Guided Investigation Framework
Author: tilmon-engineering

bytilmon-engineering

•

Data Science & ML

Conducts systematic, multi-phase investigations into complex, open-ended data questions using structured decomposition and incremental synthesis.

The Guided Investigation skill provides a rigorous 5-phase methodology for tackling exploratory 'Why?' or 'What's driving X?' questions within Claude Code. It moves beyond simple querying by enforcing a workflow that includes question decomposition, data mapping, per-sub-question investigation, cross-finding synthesis, and actionable recommendations. By requiring explicit checkpoints and documentation at every stage, it ensures that data-driven investigations are focused, thorough, and auditable, preventing the common pitfall of chasing random patterns without a clear framework.

Key Features

01Integrated data profiling and SQL query construction for SQLite databases

02Incremental documentation and per-sub-question analysis tracking

032 GitHub stars

04Systematic 5-phase investigation workflow from decomposition to recommendations

05Structured sub-question mapping to prevent unfocused data exploration

06Mandatory progress tracking and checkpoint verification using TodoWrite

Use Cases

01Exploratory data analysis of complex datasets with multiple variables

02Root cause analysis for business metrics like customer churn or revenue drops

03Generating structured strategic recommendations from raw data findings

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tilmon-engineering/claude-skills guided-investigation

For use in Claude.ai and ChatGPT

Download Skill