---
name: writing-specs
description: |
  Invoke this skill when initiating an OCI analysis from a plan or user prompt — i.e. before any notebook is parameterized or executed.
  Keywords:
  - analysis spec, eval spec, spec.yaml
  - treatment, outcome, covariates, confounders
  - ATE, ATT, ATO, ato_threshold
  - econml.ipynb, analysis_notebook
  - ACIC, acic_treatment, acic_response
---

Process
- Confirm the plan or prompt names a tabular data source (table or CSV) with a treatment column and an outcome column. If either is missing, ask the user before drafting.
- specs are YAML files. Write them under `specs/{plan}/`. Create the folder if it does not exist.
- Point `analysis_notebook` at an .ipynb file in `notebooks/`.

Validation (before saving)
- (skip for ACIC evals) Treatment and outcome columns exist in the data source
- `covariates` is non-empty and excludes the treatment and outcome columns.
- At least one estimand toggle (`estimate_ate` / `estimate_att` / `estimate_ato`) is true.
- `ato_threshold` is in (0, 0.5).
- `analysis_notebook` exists in `notebooks/`.

Fields — general analyses
- data_path, treatment, outcome
- covariates
- estimate_ate, estimate_att, estimate_ato
- ato_threshold
- seed
- analysis_notebook

Fields — ACIC evals only
- acic_treatment, acic_response   # replace data_path / treatment / outcome
- covariates
- seed
- estimate_ate, estimate_att, estimate_ato
- ato_threshold
- analysis_notebook: econml.ipynb