---
name: brycewang-stanford/new-notebook
source: https://app.decimal.ai/s/brycewang-stanford-new-notebook@1/SKILL.md
source_sha256: fb12a5ba269e
---

# Create New Notebook

Create a new Jupyter notebook with Jupytext pairing and register it in the manuscript.

## Arguments

- `$ARGUMENTS` — the notebook name and title (e.g., "notebook-02 Regression Analysis")

## Steps

1. Parse the name and title from the arguments. Follow the naming convention: `notebook-NN.ipynb` (sequential numbering)
2. Check `notebooks/` for existing notebooks to determine the next number
3. Create the `.ipynb` file in `notebooks/` with:
   - The correct kernel (ask user: Python, R, or Stata)
   - A first code cell with the setup appropriate for the chosen kernel:
     - **Python:** `import sys; sys.path.insert(0, ".."); from config import set_seeds, DATA_DIR; set_seeds()`
     - **R:** `source("../config.R"); set_seeds()`
     - **Stata:** `clear all` followed by `set seed 42`
   - A markdown cell with the notebook title
4. Create the Jupytext `.md` pair by running: `uv run jupytext --set-formats ipynb,md:myst notebooks/<name>.ipynb`
5. Register the notebook in `_quarto.yml` under `manuscript.notebooks`:
   ```yaml
   - notebook: notebooks/<name>.ipynb
     title: "N<number>: <title>"
   ```
6. Confirm the notebook renders: `quarto render notebooks/<name>.ipynb`