Skip to content

brycewang-stanford/Auto-Empirical-Research-Skills / skills/23-Learning-Bayesian-Statistics-baygent-skills/causal-inference

causal-inference

Verified

Production-grade Bayesian causal inference with PyMC, CausalPy, and DoWhy. Enforces DAG-first thinking, mandatory user checkpoints for assumptions, design-specific refutation, and defensible reporting with causal language guardrails. Trigger on: causal inference, causal effect estimation, treatment effects, counterfactuals, difference-in-differences (DiD), synthetic control, regression discontinuity (RDD), interrupted time series (ITS), instrumental variables (IV), propensity scores, DAGs, causal graphs, confounders, backdoor criterion, do-calculus, interventional distributions, pm.do(), pm.observe(), CausalPy, DoWhy, mediation analysis, refutation, sensitivity analysis, parallel trends, placebo tests, or any question of the form "does X cause Y" or "what is the effect of X on Y."

FileKindSize
README.mdmarkdown4.4 KB
SKILL.mdskill md8.0 KB
references/dags-and-identification.mdmarkdown8.4 KB
references/quasi-experiments.mdmarkdown18.8 KB
references/refutation.mdmarkdown22.2 KB
references/reporting.mdmarkdown10.8 KB
references/structural-models.mdmarkdown7.5 KB
# causal-inference

An opinionated [Agent Skill](https://agentskills.io) for production-grade Bayesian causal inference using PyMC, CausalPy, and DoWhy.

Compatible with Claude Code, Kimi Code, Cursor, Gemini CLI, and any agent that supports the [Agent Skills spec](https://agentskills.io/specification).

Full breakdown [here](https://learnbayesstats.com/blog-posts/causal-inference-agent-skill-pymc-causalpy-dowhy).

## What it does

Guides your coding agent through the full causal inference workflow, enforcing DAG-first thinking and mandatory assumption checkpoints:

1. **Formulate the causal question** — Precise estimand (ATE, ATT, LATE, etc.)
2. **Draw the DAG** — Explicit causal graph with nodes, edges, and non-edges
3. **Identify** — Backdoor, front-door, IV, RDD, DiD
4. **Choose design** — Match problem to method (DiD, synthetic control, ITS, RDD, IV, IPSW, structural)
5. **Estimate** — Build and fit the model (delegates PyMC mechanics to bayesian-workflow)
6. **Refute** — Mandatory design-specific robustness checks (placebo tests, sensitivity analysis, falsification)
7. **Interpret** — Effect size + decision-relevant HDIs + probability of direction
8. **Report** — Defensible causal language with assumption-first structure

The skill enforces guardrails that agents won't apply on their own: no estimation without a confirmed DAG, no causal claims without refutation, assumptions stated before results, and automatic downgrading of causal language when warranted.

## Install

This skill requires the **bayesian-workflow** skill for all PyMC modeling steps (priors, sampling, diagnostics, calibration, reporting). Install both together.

### Claude Code

```bash
git clone https://github.com/Learning-Bayesian-Statistics/baygent-skills.git /tmp/baygent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/baygent-skills/bayesian-workflow ~/.claude/skills/
cp -r /tmp/baygent-skills/causal-inference ~/.claude/skills/
```

For project-level installation (available only in that project), copy into `.claude/skills/` at the project root instead.

### Other compatible agents (Kimi Code, Cursor, etc.)

```bash
git clone https://github.com/Learning-Bayesian-Statistics/baygent-skills.git /tmp/baygent-skills
cp -r /tmp/baygent-skills/bayesian-workflow/ ~/.config/agents/skills/bayesian-workflow/
cp -r /tmp/baygent-skills/causal-inference/ ~/.config/agents/skills/causal-inference/
```

### Python dependencies

```bash
mamba install -c conda-forge pymc nutpie arviz arviz-stats causalpy dowhy
```

## Example prompts

Once installed, just ask your agent naturally:

- *"We ran a marketing campaign in 3 cities starting in March. I have monthly revenue data for those cities plus 10 control cities. Did the campaign work?"*
- *"I have observational data on a drug treatment. Help me estimate the causal effect controlling for confounders."*
- *"Does X cause Y? I have panel data with a treatment that rolled out at different times across regions."*
- *"I need to estimate the effect of a policy change using regression discontinuity — students above a test score threshold got a scholarship."*
- *"Build a synthetic control for California's tobacco tax using other states as donors."*

## Design selection guide

| Design | Use when | Tool |
|---|---|---|
| DiD | Treatment at known time, control group available | CausalPy |
| Staggered DiD | Treatment rolls out at different times | CausalPy |
| Synthetic Control | Single treated unit, donor pool available | CausalPy |
| ITS | Time series, intervention at known time, no control | CausalPy |
| RDD | Treatment by threshold on running variable | CausalPy |
| IV | Endogenous treatment, valid instrument | CausalPy |
| IPSW | Observational data, treatment modeled | CausalPy |
| Structural (do/observe) | Full causal theory, model mechanisms | PyMC |
| Counterfactual | "What would Y have been if X differed?" | PyMC |

## What's included

```
causal-inference/
├── SKILL.md                          # Main workflow instructions
└── references/
    ├── dags-and-identification.md    # DAG construction, backdoor/front-door criteria
    ├── quasi-experiments.md          # DiD, synthetic control, ITS, RDD, IV, IPSW
    ├── structural-models.md          # pm.do(), pm.observe(), counterfactuals
    ├── refutation.md                 # Design-specific robustness checks
    └── reporting.md                  # Causal language guardrails, report templates
```

## License

MIT - see [LICENSE](../LICENSE).
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall