OpenParable
Skip to content
← Back to skills

New Notebook

Development
new-notebook

New 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  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:
    - notebook: notebooks/<name>.ipynb
      title: "N<number>: <title>"
    
  6. Confirm the notebook renders: quarto render notebooks/<name>.ipynb