Jupyter notebooks
Creates and tidies Jupyter notebooks for experiments or tutorials from bundled templates via a stdlib script, with structure patterns and a run-top-to-bottom checklist. Use when starting a notebook or turning a messy one into something others can rerun.
jupyter-notebook- Author
- OpenAI
- Source
- openai/skills/skills/.curated/jupyter-notebook @ 49f948f
- License
- Apache-2.0
About this skill
What it does
The skill has the agent create or tidy .ipynb notebooks of two kinds, experiments and tutorials. It picks the kind first: exploratory or hypothesis-driven work is an experiment, step-by-step teaching is a tutorial, and an existing notebook is a refactor that keeps its intent. It also notes the objective, the audience and what "done" means.
New notebooks start from a template, not hand-written JSON. scripts/new_notebook.py (standard library only) copies assets/experiment-template.ipynb or assets/tutorial-template.ipynb, sets the title cell and writes the file; it will not overwrite one without --force. The experiment template opens with an objective, a seeded setup cell and a plan for hypotheses, sweeps and metrics. Four references set the rest: experiment-patterns.md (baseline first, results next to the code, a decision on next steps), tutorial-patterns.md (audience and prerequisites, an outline, explain-run-interpret steps, at least one exercise with an answer scaffold), notebook-structure.md (safe edits to the raw JSON) and quality-checklist.md (run top to bottom, no hidden state, short outputs). When the notebook cannot be run, the agent says so and explains how to check it locally.
When to use it, and when not
Use it to start an analysis or teaching notebook, or to turn a messy notebook or a script into one that others can read and rerun.
It is about structure, not any particular library or analysis, and adds little when a plain script or one chart is enough.
How to run it
The install command below puts the whole folder in place: SKILL.md, the script, both templates, the references, the icons, the Codex metadata file and the licence. The skill runs the script with uv run --python 3.12; plain python works too. Executing notebooks needs jupyterlab and ipykernel. The skill builds the script path from $CODEX_HOME/skills/, so in other agents point it at your install folder, and pass --out: the default output path depends on where the skill is installed, not on your project. To call it:
- Claude Code:
/jupyter-notebook, or ask for the skill by name. - Codex:
$jupyter-notebook. - Cursor: type
/in the Agent chat and pickjupyter-notebook.
Example: /jupyter-notebook Make an experiment notebook that compares three prompt variants on our eval set.
OpenAI has marked openai/skills deprecated; our copy is pinned to a commit there, and as of November 2026 openai/plugins has no newer version of this skill. The jupyter-notebooks skill in its data-analytics plugin is a different one, for SQL and Python analysis notebooks.
How it differs from similar skills
Nothing else in the catalog works with notebooks. Excel spreadsheets (.xlsx) is the nearest neighbour for data deliverables, but it produces spreadsheets and CSV files, not runnable notebooks.
Install
Run one command — it saves SKILL.md and the files it uses into your agent's skills folder. Claude Code and Codex pick up a new skill without a restart; if it does not show up, restart the agent.
curl -fsSL --create-dirs -o ~/.claude/skills/jupyter-notebook/SKILL.md https://anymodel.org/en/skills/openai/jupyter-notebook/SKILL.md -o ~/.claude/skills/jupyter-notebook/LICENSE.txt https://anymodel.org/en/skills/openai/jupyter-notebook/LICENSE.txt -o ~/.claude/skills/jupyter-notebook/agents/openai.yaml https://anymodel.org/en/skills/openai/jupyter-notebook/agents/openai.yaml -o ~/.claude/skills/jupyter-notebook/assets/experiment-template.ipynb https://anymodel.org/en/skills/openai/jupyter-notebook/assets/experiment-template.ipynb -o ~/.claude/skills/jupyter-notebook/assets/jupyter-small.svg https://anymodel.org/en/skills/openai/jupyter-notebook/assets/jupyter-small.svg -o ~/.claude/skills/jupyter-notebook/assets/jupyter.png https://anymodel.org/en/skills/openai/jupyter-notebook/assets/jupyter.png -o ~/.claude/skills/jupyter-notebook/assets/tutorial-template.ipynb https://anymodel.org/en/skills/openai/jupyter-notebook/assets/tutorial-template.ipynb -o ~/.claude/skills/jupyter-notebook/references/experiment-patterns.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/experiment-patterns.md -o ~/.claude/skills/jupyter-notebook/references/notebook-structure.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/notebook-structure.md -o ~/.claude/skills/jupyter-notebook/references/quality-checklist.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/quality-checklist.md -o ~/.claude/skills/jupyter-notebook/references/tutorial-patterns.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/tutorial-patterns.md -o ~/.claude/skills/jupyter-notebook/scripts/new_notebook.py https://anymodel.org/en/skills/openai/jupyter-notebook/scripts/new_notebook.py
curl -fsSL --create-dirs -o ~/.agents/skills/jupyter-notebook/SKILL.md https://anymodel.org/en/skills/openai/jupyter-notebook/SKILL.md -o ~/.agents/skills/jupyter-notebook/LICENSE.txt https://anymodel.org/en/skills/openai/jupyter-notebook/LICENSE.txt -o ~/.agents/skills/jupyter-notebook/agents/openai.yaml https://anymodel.org/en/skills/openai/jupyter-notebook/agents/openai.yaml -o ~/.agents/skills/jupyter-notebook/assets/experiment-template.ipynb https://anymodel.org/en/skills/openai/jupyter-notebook/assets/experiment-template.ipynb -o ~/.agents/skills/jupyter-notebook/assets/jupyter-small.svg https://anymodel.org/en/skills/openai/jupyter-notebook/assets/jupyter-small.svg -o ~/.agents/skills/jupyter-notebook/assets/jupyter.png https://anymodel.org/en/skills/openai/jupyter-notebook/assets/jupyter.png -o ~/.agents/skills/jupyter-notebook/assets/tutorial-template.ipynb https://anymodel.org/en/skills/openai/jupyter-notebook/assets/tutorial-template.ipynb -o ~/.agents/skills/jupyter-notebook/references/experiment-patterns.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/experiment-patterns.md -o ~/.agents/skills/jupyter-notebook/references/notebook-structure.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/notebook-structure.md -o ~/.agents/skills/jupyter-notebook/references/quality-checklist.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/quality-checklist.md -o ~/.agents/skills/jupyter-notebook/references/tutorial-patterns.md https://anymodel.org/en/skills/openai/jupyter-notebook/references/tutorial-patterns.md -o ~/.agents/skills/jupyter-notebook/scripts/new_notebook.py https://anymodel.org/en/skills/openai/jupyter-notebook/scripts/new_notebook.py
foreach ($f in 'SKILL.md','LICENSE.txt','agents/openai.yaml','assets/experiment-template.ipynb','assets/jupyter-small.svg','assets/jupyter.png','assets/tutorial-template.ipynb','references/experiment-patterns.md','references/notebook-structure.md','references/quality-checklist.md','references/tutorial-patterns.md','scripts/new_notebook.py') { $p = Join-Path "$HOME\.claude\skills\jupyter-notebook" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/openai/jupyter-notebook/$f" -UseBasicParsing -OutFile $p }foreach ($f in 'SKILL.md','LICENSE.txt','agents/openai.yaml','assets/experiment-template.ipynb','assets/jupyter-small.svg','assets/jupyter.png','assets/tutorial-template.ipynb','references/experiment-patterns.md','references/notebook-structure.md','references/quality-checklist.md','references/tutorial-patterns.md','scripts/new_notebook.py') { $p = Join-Path "$HOME\.agents\skills\jupyter-notebook" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/openai/jupyter-notebook/$f" -UseBasicParsing -OutFile $p }Any other agent: save the file into its skills folder, or give it the link to the file: https://anymodel.org/en/skills/openai/jupyter-notebook/SKILL.md
SKILL.md
Jupyter Notebook Skill
Create clean, reproducible Jupyter notebooks for two primary modes:
- Experiments and exploratory analysis
- Tutorials and teaching-oriented walkthroughs
Prefer the bundled templates and the helper script for consistent structure and fewer JSON mistakes.
When to use
- Create a new
.ipynbnotebook from scratch. - Convert rough notes or scripts into a structured notebook.
- Refactor an existing notebook to be more reproducible and skimmable.
- Build experiments or tutorials that will be read or re-run by other people.
Decision tree
- If the request is exploratory, analytical, or hypothesis-driven, choose
experiment. - If the request is instructional, step-by-step, or audience-specific, choose
tutorial. - If editing an existing notebook, treat it as a refactor: preserve intent and improve structure.
Skill path (set once)
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
User-scoped skills install under $CODEX_HOME/skills (default: ~/.codex/skills).
Workflow
Lock the intent. Identify the notebook kind:
experimentortutorial. Capture the objective, audience, and what "done" looks like.Scaffold from the template. Use the helper script to avoid hand-authoring raw notebook JSON.
uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
--kind experiment \
--title "Compare prompt variants" \
--out output/jupyter-notebook/compare-prompt-variants.ipynb
uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
--kind tutorial \
--title "Intro to embeddings" \
--out output/jupyter-notebook/intro-to-embeddings.ipynb
Fill the notebook with small, runnable steps. Keep each code cell focused on one step. Add short markdown cells that explain the purpose and expected result. Avoid large, noisy outputs when a short summary works.
Apply the right pattern. For experiments, follow
references/experiment-patterns.md. For tutorials, followreferences/tutorial-patterns.md.Edit safely when working with existing notebooks. Preserve the notebook structure; avoid reordering cells unless it improves the top-to-bottom story. Prefer targeted edits over full rewrites. If you must edit raw JSON, review
references/notebook-structure.mdfirst.Validate the result. Run the notebook top-to-bottom when the environment allows. If execution is not possible, say so explicitly and call out how to validate locally. Use the final pass checklist in
references/quality-checklist.md.
Templates and helper script
- Templates live in
assets/experiment-template.ipynbandassets/tutorial-template.ipynb. - The helper script loads a template, updates the title cell, and writes a notebook.
Script path:
$JUPYTER_NOTEBOOK_CLI(installed default:$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)
Temp and output conventions
- Use
tmp/jupyter-notebook/for intermediate files; delete when done. - Write final artifacts under
output/jupyter-notebook/when working in this repo. - Use stable, descriptive filenames (for example,
ablation-temperature.ipynb).
Dependencies (install only when needed)
Prefer uv for dependency management.
Optional Python packages for local notebook execution:
uv pip install jupyterlab ipykernel
The bundled scaffold script uses only the Python standard library and does not require extra dependencies.
Environment
No required environment variables.
Reference map
references/experiment-patterns.md: experiment structure and heuristics.references/tutorial-patterns.md: tutorial structure and teaching flow.references/notebook-structure.md: notebook JSON shape and safe editing rules.references/quality-checklist.md: final validation checklist.
Connect through AnyModel API
This skill runs on whatever model your agent uses. Point Claude Code, Codex or Cursor at AnyModel to run it on Claude, GPT, Gemini and more with one key — pay per token, no subscription.
AnyModel