notebook.create_outline

Goal

• Create a comprehensive outline for an interactive Jupyter notebook that teaches a concept (passed from the user) through visualization and hands-on exploration
• The outline is a markdown file that describes what each notebook cell contains, without writing any code, as a blueprint for implementation

Key Principles

• Follow the section # Design Principles and Setup in .claude/skills/notebook.rules.md
• The output is notebook_outline.<TAG>.md, describing the notebook units
• Say in the output file how it was generated, with this line right after the title:

  - Generated by `.claude/skills/notebook.create_outline/SKILL.md`
  

• Save the file in the current dir
• Do not write any code

Outline Unit Structure

• Each unit in the outline corresponds to a triplet of cells in the final notebook:
  • Markdown cell: Section header, goal, and description of the panels and controls (before viz)
  • Code cell: Visualization, widgets, and interactive controls
  • Markdown cell: Guided usage, actions plus observations, then the implementation (after viz)

Numbering and Naming

• Number units incrementally:
  • E.g., Cell 1, Cell 2, etc
• Use descriptive titles that signal the learning objective
  • Not just "Plot" or "Widget"
• Keep titles concise (5-7 words)

Outline Unit Description Template

• Use this structure for each unit:

  ## Cell i: <Concise Learning Objective>
  
  **Goal**
  - <Learning objective 1>
  - <Learning objective 2>
  
  **Plots and their descriptions**
  - `<Plot 1 name>`: <Description of what it shows>
  - `<Plot 2 name>`: <Description of what it shows>
  - `Comments`: Current parameter values and state observations
  
  **Widgets** (if applicable)
  - `<widget name>`: <description, range, effect on display>
  - Each widget description is close to the widget itself
  
  **Guided usage** (post-visualization)
  - <Action on a widget, plus the observation it produces>
  - <Action on a widget, plus the observation it produces>
  
  **Implementation** Libraries and functions used