跳到正文
cccskills
免费在 GitHub 公开

causal-inference

Choose and implement methods for estimating causal effects from observational data or policy changes. Guidance covers method assumptions, estimation, diagnostic checks, and robustness tests that examine whether findings hold under alternative analysis choices.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

This skill covers causal inference methods in observational and quasi-experimental settings. Use when the user is implementing, choosing between, or debugging causal identification strategies — including instrumental variables, difference-in-differences, regression discontinuity, synthetic control, or matching estimators. Triggers on "causal effect", "identification strategy", "instrumental variable", "2SLS", "GMM", "difference-in-differences", "DiD", "staggered treatment", "regression discontinuity", "RDD", "synthetic control", "matching", "propensity score", "IPW", "AIPW", "doubly robust", "LATE", "ATT", "ATE", "parallel trends", "exclusion restriction", "first stage", "weak instruments", or "endogeneity".

实测评分 未实测

查看安装方法

适用场景

  • Choosing a causal method for evaluating a policy change
  • Analyzing policies introduced at different times across regions
  • Checking instrumental variable strength and underlying assumptions
  • Testing result stability across analysis settings

包含的文件(4)

  • SKILL.md12.3 KB
  • references/method-implementations.md10.9 KB
  • references/staggered-did.md3.3 KB
  • references/synthetic-control.md3.5 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Causal Inference

Reference for implementing causal inference methods: from identification strategy to estimation to diagnostics and robustness. Covers the major quasi-experimental and observational methods used in applied economics and quantitative social science.

When to Use This Skill

Use when the user is:

  • Choosing an identification strategy for a causal question
  • Implementing IV/2SLS, DiD, RDD, synthetic control, or matching
  • Debugging specification issues (weak instruments, parallel trends violations, bandwidth sensitivity)
  • Running robustness checks or falsification tests
  • Working with modern DiD methods for staggered treatment timing

Skip when:

  • The task is structural estimation (use structural-modeling skill)
  • The task is pure prediction/ML (no causal question)
  • The user needs simulation design (use numerical-auditor agent)

Where to Start

  • Choosing a method? Jump to Method Selection Guide at the end
  • Implementing a specific method? Go directly to that method's section below
  • Need full code? See references/method-implementations.md for complete implementations

Frameworks

Two complementary frameworks underpin all causal inference:

Potential Outcomes (Rubin): Define Y(1), Y(0) as potential outcomes under treatment and control. The causal effect is τ = Y(1) - Y(0). The fundamental problem: we never observe both for the same unit. All methods are strategies for constructing valid counterfactuals.

DAGs (Pearl): Graphical models encoding conditional independence assumptions. Use d-separation to determine what must be conditioned on (and what must NOT be conditioned on) to identify causal effects. Particularly useful for reasoning about bad controls (colliders, mediators), overcontrol bias, and which instruments satisfy the exclusion restriction.

Quick Reference: Methods at a Glance

MethodKey AssumptionTarget ParameterKey Package
IV/2SLSExclusion restriction, monotonicityLATElinearmodels (Py), fixest (R), ivregress (Stata)
DiDParallel trendsATTfixest (R), reghdfe (Stata), linearmodels (Py)
RDDNo manipulation, local continuityLATE at cutoffrdrobust (all)
Synthetic ControlWeights reproduce pre-treatment trendsATT (single unit)Synth/augsynth (R)
Matching/AIPWSelection on observablesATE or ATTeconml (Py), MatchIt/WeightIt (R)

Target Parameters

Be precise about what parameter you are estimating:

ParameterDefinitionEstimated by
ATEE[Y(1) - Y(0)]Randomized experiment, IPW, AIPW
ATTE[Y(1) - Y(0) | D=1]DiD, matching, selection-on-observables
LATEE[Y(1) - Y(0) | compliers]IV/2SLS (Imbens-Angrist 1994)
ATT(g,t)Group-time specific treatment effectStaggered DiD (Callaway-Sant'Anna)

Common mistake: IV estimates LATE, not ATE. DiD estimates ATT, not ATE. This matters for policy interpretation.

Instrumental Variables (IV/2SLS)

Key idea: Find a variable Z that shifts D (first stage) but affects Y only through D (exclusion restriction).

from linearmodels.iv import IV2SLS

result = IV2SLS.from_formula(
    'lwage ~ 1 + exper + expersq + [educ ~ nearc4 + nearc2]',
    data=df
).fit(cov_type='robust')

# Always check first-stage F > 10; report LIML as robustness with weak instruments

For R/Stata implementations, weak instrument corrections (LIML, Anderson-Rubin), and overidentification tests, see references/method-implementations.md.

IV Diagnostics Checklist:

  • First-stage F > 10 (or Olea-Pflueger effective F for robust inference)
  • Exclusion restriction argued substantively (not testable)
  • Monotonicity for LATE interpretation (no defiers)
  • Reduced form significant (regress Y directly on Z)
  • Overidentification test reported if over-identified
  • Compare OLS vs 2SLS — direction and magnitude as expected?
  • Report LATE interpretation — who are the compliers?

Difference-in-Differences (DiD)

Key idea: Compare changes over time between treated and control groups, assuming they would have followed parallel trends absent treatment.

import statsmodels.formula.api as smf

# Standard 2x2 DiD
result = smf.ols('y ~ treated + post + treated:post', data=df).fit(
    cov_type='cluster', cov_kwds={'groups': df['state']}
)
# Coefficient on treated:post is the DiD estimate

Staggered treatment timing: With staggered adoption, TWFE can produce sign-reversed estimates due to negative weights. Use:

  • Callaway-Sant'Anna (did R package): Most flexible aggregation, doubly robust
  • Sun-Abraham (fixest::sunab): Integrates directly into feols; simpler for event studies
  • Bacon decomposition (bacondecomp R): Diagnose how much weight TWFE puts on contaminated comparisons

For full staggered DiD code (C-SA, Sun-Abraham, BJS24, de Chaisemartin-D'H), see references/staggered-did.md. For event study code and HonestDiD pre-trend sensitivity, see references/method-implementations.md.

DiD Diagnostics Checklist:

  • Pre-trends: Event study shows no significant pre-treatment coefficients
  • Parallel trends sensitivity: Rambachan-Roth or similar analysis
  • Staggered timing: If varies, use C-SA or S-A — NOT naive TWFE
  • Clustering at level of treatment assignment (typically state/county)
  • Anticipation: Check period just before treatment
  • Bacon decomposition if using TWFE

Regression Discontinuity (RDD)

Key idea: Units just above and below a threshold are locally comparable; the jump at the threshold identifies the causal effect.

from rdrobust import rdrobust, rdbwselect, rdplot

# Basic sharp RD with bias-corrected robust CI
result = rdrobust(y=df['outcome'], x=df['running_var'], c=0)
# Reports: point estimate, robust CI, MSE-optimal bandwidth, N left/right

# Density test for manipulation
from rddensity import rddensity
density_test = rddensity(X=df['running_var'], c=0)

For fuzzy RDD, bandwidth sensitivity tables, and R/Stata implementations, see references/method-implementations.md.

RDD Diagnostics Checklist:

  • McCrary density test: No manipulation of running variable at cutoff
  • Covariate balance: Run RD on predetermined covariates as placebo outcomes
  • Bandwidth sensitivity: Results stable across 0.5×, 0.75×, 1×, 1.5×, 2× optimal
  • Local linear (p=1) is standard — avoid high-order polynomials
  • Donut hole: Drop observations very close to cutoff
  • Placebo cutoffs: Run RD where no effect should exist

Synthetic Control

When to use: Single or very few treated units, long pre-treatment series, no obvious comparison group. SC constructs a synthetic counterfactual as a weighted average of donor units.

Key packages: R: Synth, tidysynth, augsynth; Python: SparseSC, SyntheticControlMethods

Diagnostics: Pre-treatment RMSPE (fit quality), permutation/placebo tests across donor units, leave-one-out stability, time placebo at earlier date.

For full implementation (Synth setup, augsynth, permutation tests), see references/synthetic-control.md and references/method-implementations.md. The identification-critic agent can evaluate SC identification assumptions.

Matching and Weighting

Key idea: Reweight control group to match treated group on observed characteristics. Only valid under selection-on-observables (no unobserved confounders).

AIPW (doubly robust) is the recommended default — consistent if either the propensity score model or the outcome model is correctly specified.

from econml.dr import LinearDRLearner
from sklearn.ensemble import GradientBoostingRegressor, GradientBoostingClassifier

# Doubly robust learner
dr = LinearDRLearner(
    model_regression=GradientBoostingRegressor(),
    model_propensity=GradientBoostingClassifier()
)
dr.fit(Y=df['y'], T=df['treatment'], X=df[covariates], W=None)
ate = dr.ate(df[covariates])

For propensity score estimation, IPW/Hajek estimators, and manual AIPW implementation, see references/method-implementations.md.

Matching Diagnostics Checklist:

  • Covariate balance: Standardized mean differences < 0.1 after weighting
  • Common support: Substantial overlap in propensity score distributions
  • Sensitivity analysis: Rosenbaum bounds
  • No post-treatment covariates in the propensity model
  • Trim if propensity scores near 0 or 1

Method Selection Guide

ScenarioRecommended MethodKey Assumption
Random assignment with imperfect complianceIV/2SLSExclusion restriction, monotonicity
Policy change at a thresholdRDDNo manipulation, local continuity
Policy change at a time point, treated and control groupsDiDParallel trends
Staggered policy adoption across unitsStaggered DiD (C-SA, S-A)Parallel trends (conditional)
Single treated unit, long pre-periodSynthetic controlWeights reproduce pre-treatment
Treatment assignment based on observablesMatching/IPW/AIPWSelection on observables

Decision heuristic:

  1. Is there a sharp threshold? → RDD
  2. Is there an instrument? → IV
  3. Is there a clean pre/post + treated/control? → DiD
  4. Only one treated unit? → Synthetic control
  5. Rich observables, selection on observables plausible? → AIPW
  6. None of the above → structural model may be needed

Common Anti-Patterns

Anti-PatternProblemBetter Approach
TWFE with staggered timing and heterogeneous effectsNegative weights, biased estimatesUse Callaway-Sant'Anna or Sun-Abraham
Reporting 2SLS without first-stage FReader cannot assess instrument strengthAlways report first-stage F (and LIML as robustness)
High-order polynomial in RDDOverfitting, poor boundary propertiesUse local linear (p=1) with rdrobust
Matching on post-treatment variablesConditioning on outcome of treatmentOnly match on pre-treatment covariates
Claiming parallel trends hold because pre-event coefficients are insignificantLow power; absence of evidence ≠ evidence of absenceUse Rambachan-Roth sensitivity analysis
IPW with extreme propensity scores (near 0 or 1)Huge variance, unstable estimatesTrim, use normalized/Hajek weights, or switch to AIPW
Reporting only one bandwidth in RDDCherry-picking concernShow results across bandwidth range
Cluster-robust SEs with few clusters (< 30-40)Poor finite-sample coverageWild cluster bootstrap (Cameron, Gelbach, Miller 2008)

Integration with compound-science

  • econometric-reviewer — Reviews identification strategy, standard errors, and asymptotic properties
  • identification-critic — Evaluates exclusion restrictions, support conditions, and identification completeness
  • identification-critic agent / identification-proofs skill — Formalize an identification argument end-to-end
  • /estimate — Run a full estimation pipeline with diagnostics
  • empirical-playbook skill (sensitivity-analysis.md) — Oster bounds, specification curve, breakdown frontier for robustness

Additional References

  • references/method-implementations.md — Full IV/2SLS, DiD event study, RDD, and matching/AIPW implementation code
  • references/staggered-did.md — Full implementation code for Callaway-Sant'Anna, Sun-Abraham, BJS24, de Chaisemartin-D'Haultfoeuille, and Bacon decomposition
  • references/synthetic-control.md — Standard SC optimizer, permutation/placebo test code, augmented SC, diagnostics checklist

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

a1

免费

Turn a broad research idea into clear, testable questions. Compare familiar and less conventional approaches, structure the selected question around its population and methods, and assess variables, feasibility, and potential theoretical contributions.

中文简介正在准备中。当前显示英语简介。

  • Turn a research topic into testable questions
  • Narrow an overly broad research question
  • Compare alternative research angles
brycewang-stanford/Auto-Empirical-Research-Skills47562026年10月20日 更新

a2

免费

Helps build a research framework by comparing theories, mapping relationships between variables, and deriving testable hypotheses. Explores less conventional options, examines weaknesses and competing explanations, and produces diagrams with anticipated reviewer objections.

中文简介正在准备中。当前显示英语简介。

  • Comparing theories for a research question
  • Deriving hypotheses from relationships between variables
  • Examining weaknesses and anticipated reviewer objections
brycewang-stanford/Auto-Empirical-Research-Skills47562026年10月20日 更新

a5

免费

Clarify the philosophical assumptions behind a research project and check whether they fit the proposed methods. Get a reasoned research stance, draft proposal wording, and guidance for explaining how the researcher's background and values shape the study.

中文简介正在准备中。当前显示英语简介。

  • Clarifying philosophical foundations for a research proposal
  • Explaining why the chosen research methods fit the study
  • Drafting a statement about the researcher's position
brycewang-stanford/Auto-Empirical-Research-Skills47562026年10月20日 更新

Plan and draft academic papers through specialized agent roles covering literature, arguments, citations, and review. Get chapter guidance, revision roadmaps, Traditional Chinese and English abstracts, and documents formatted as LaTeX, DOCX, PDF, or Markdown.

中文简介正在准备中。当前显示英语简介。

  • Planning a paper chapter by chapter
  • Drafting a paper from research materials
  • Turning reviewer comments into a revision roadmap
brycewang-stanford/Auto-Empirical-Research-Skills47562026年10月20日 更新

Turn a detailed outline into a philosophy or interdisciplinary manuscript. Draft chapters with repeated quality reviews, check terminology and arguments across sections, and prepare the manuscript, evaluation reports, abstract, and metadata for submission.

中文简介正在准备中。当前显示英语简介。

  • Draft a full paper from a detailed outline
  • Review argument and citation quality chapter by chapter
  • Check terminology and argument flow across chapters
brycewang-stanford/Auto-Empirical-Research-Skills47562026年10月20日 更新

Simulate academic peer review through five reviewer roles tailored to the paper's field. Receive separate critiques, an editorial decision, and a prioritized revision roadmap, or check whether a revised manuscript addresses earlier comments.

中文简介正在准备中。当前显示英语简介。

  • Review a manuscript before journal submission
  • Examine research methods and statistical validity
  • Challenge core arguments and alternative explanations
brycewang-stanford/Auto-Empirical-Research-Skills47562026年10月20日 更新

查看 brycewang-stanford 的全部技能

报告此技能的问题