← LeaderboardThe Skill Leaderboard

new-notebook

Creates a Jupyter notebook with Jupytext pairing and registers it in _quarto.yml. Use when adding a new notebook.

Published by brycewang-stanford ↗brycewang-stanford/Auto-Empirical-Research-Skills

Try your first task

new-notebook

Start a fresh conversation. Replace the highlighted placeholders.

Use new-notebook to create the next sequential notebook for [title] using the [kernel] kernel, pair it with Jupytext, register it in the manuscript, and render it.

Required inputs

  • [title]
  • [kernel]

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: new-notebookdescription: Creates a Jupyter notebook with Jupytext pairing and registers it in _quarto.yml. Use when adding a new notebook.argument-hint: <name> <title>allowed-tools: Bash, Read, Write, Edit, Glob, Grep

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
new-notebook by brycewang-stanford · The Skill Leaderboard