pre-analysis-plan

Locks hypotheses, estimands, and specifications before outcome data is seen.

2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/lancegui/causal-powers --skill pre-analysis-plan-lancegui
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pre-analysis-plan
Source: https://github.com/lancegui/causal-powers/tree/main/skills/pre-analysis-plan
Command: npx skills add https://github.com/lancegui/causal-powers --skill pre-analysis-plan-lancegui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Confirmatory analyses lose credibility when specifications are chosen after seeing results. This Skill prevents specification searching and p-hacking by locking the hypotheses, estimand, primary specification, sample rules, robustness suite, and decision rule before any outcome data is touched. ## Core Features & Use Cases - Pre-committed analysis lock: Fixes six elements — directional hypotheses with multiple-comparisons correction, the exact estimand, one primary specification, sample and exclusion rules, a small targeted robustness suite, and a decision rule with power/MDE commitments. - Blinding gate with sign-off: Persists the plan to a file (e.g., docs/pre-analysis-plan.md) and requires explicit user sign-off before outcome data is loaded, plotted, or inspected. - Confirmatory vs. exploratory separation: Keeps a bright line between pre-registered claims and exploratory findings, routing deviations through a checkpoint rather than silent judgment calls. - Use Case: Before reading out an A/B test or policy evaluation, use this Skill to write down the primary metric, model, sample rules, and what would count as a null result — then get sign-off before unblinding the outcomes. ## Quick Start Before we look at any results, help me write a pre-analysis plan that locks the hypothesis, primary specification, sample rules, and decision rule for this experiment.

Frequently Asked Questions about pre-analysis-plan

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

FAQPage Schema
How do I write a pre-analysis plan for an A/B test?▼

A pre-analysis plan locks six items before outcomes are seen: directional hypotheses with a multiple-comparisons correction, the exact estimand, one primary specification, sample and exclusion rules, a small robustness suite, and a decision rule with power commitments. Persist it to a file and get sign-off before unblinding results.

When should I use a pre-analysis plan versus exploratory analysis?▼

Use a pre-analysis plan when the result drives a decision, you have a stake in the outcome, the claim is causal, or the work will be scrutinized. Genuine exploration does not need one — label it exploratory and confirm interesting findings on fresh data.

What should a pre-analysis plan include for causal inference?▼

It should fix the estimand (ATE/ATT/LATE/ITT) on a defined population, one primary specification with functional form, controls, fixed effects, and SE clustering, pre-committed exclusion rules, a targeted robustness suite, and a null definition with minimum detectable effect.

Can I deviate from a pre-analysis plan after seeing the data?▼

Deviations are allowed but must be treated as a checkpoint, not a silent judgment call. Stop, present the proposed change and rationale to the user, and report both the pre-registered and revised analyses once approved.

Why is peeking at outcome data before finalizing the analysis a problem?▼

Once outcomes are seen, every later specification choice is contaminated by that knowledge, turning confirmatory analysis into specification search. The plan must be signed off while everyone is still blind to the treatment-outcome relationship.