New Notebook
Developmentnew-notebookNew Notebook is an Agent Skill for development published in the brycewang-stanford/Auto-Empirical-Research-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Creates a Jupyter notebook with Jupytext pairing and registers it in _quarto.yml. Use when adding a new notebook.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/HEAD/skills/29-quarcs-lab-project20XXy/dot-claude/skills/new-notebook/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/new-notebook, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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
- Parse the name and title from the arguments. Follow the naming convention:
notebook-NN.ipynb(sequential numbering) - Check
notebooks/for existing notebooks to determine the next number - Create the
.ipynbfile innotebooks/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 allfollowed byset seed 42
- Python:
- A markdown cell with the notebook title
- Create the Jupytext
.mdpair by running:uv run jupytext --set-formats ipynb,md:myst notebooks/<name>.ipynb - Register the notebook in
_quarto.ymlundermanuscript.notebooks:- notebook: notebooks/<name>.ipynb title: "N<number>: <title>" - Confirm the notebook renders:
quarto render notebooks/<name>.ipynb