question-framing

Defines the estimand, population, unit, and decision before any data analysis begins.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analyses often produce a precise, validated answer to the wrong question because the metric, population, or unit of observation was never pinned down before touching the data. This Skill forces a short framing brief — estimand, decision, population, unit, and what result would flip the decision — to be written and signed off before any code runs. ## Core Features & Use Cases - Framing brief: Pins the decision, exact metric (numerator, denominator, unit, time window), population filters, and unit of observation before loading data. - Routing logic: Directs the work to the right next step — pre-analysis plan for confirmatory questions, causal identification for in-data effects, structural estimation for counterfactuals outside the data, or an everyday analysis plan for exploratory work. - Visualization framing: Treats maps, charts, and dashboards as data deliverables, requiring mark-level unit, encoding, and join-cardinality definitions before plotting. - Use Case: A stakeholder asks "did the pricing change work?" The Skill produces a brief defining the treatment, counterfactual, estimand type (e.g., ATT on 30-day retention), and decision threshold, then routes to causal identification before any regression is run. ## Quick Start Before analyzing this dataset, frame the question by defining the exact metric, population, unit of observation, and the decision it informs, then get my sign-off.

Frequently Asked Questions about question-framing

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

FAQPage Schema
How do I define a metric before starting data analysis?▼

Write a framing brief that pins the numerator, denominator, unit of observation, and time window in one sentence each, plus the decision the number informs. Get the requester to confirm the definition before loading any data.

How do I frame a causal question like "did the policy work"?▼

Define the treatment precisely, name the counterfactual comparison group, and pick an estimand type such as ATE, ATT, LATE, or intent-to-treat. If the result will drive a decision, lock a pre-analysis plan before seeing outcomes.

When should I use structural estimation instead of reduced-form analysis?▼

Use structural estimation when the decision needs a counterfactual the data does not contain, such as a post-merger equilibrium, a welfare figure, or a price that was never observed. If a comparison inside the data answers the question, stay reduced-form.

Why do dashboards and maps need question framing?▼

Visualizations are deliverables built from data, so mis-specified units and joins silently corrupt them — a fan-out join double-plots facilities and spatial joins drop unmatched points without error. Framing pins what each mark represents and each join's expected cardinality.

What happens if the metric definition changes mid-analysis?▼

Stop and surface the change for re-confirmation rather than absorbing it silently. A definition that drifts after seeing the data means you are answering a different question than the one that was approved.