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.

Databases & SQLPack: OpenAI skills107 linesjupyter-notebook
Author
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 pick jupyter-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.

Claude Code — macOS, Linux
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
Codex, Cursor — macOS, Linux
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
Claude Code — Windows PowerShell
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 }
Codex, Cursor — Windows PowerShell
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

Raw

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 .ipynb notebook 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

  1. Lock the intent. Identify the notebook kind: experiment or tutorial. Capture the objective, audience, and what "done" looks like.

  2. 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
  1. 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.

  2. Apply the right pattern. For experiments, follow references/experiment-patterns.md. For tutorials, follow references/tutorial-patterns.md.

  3. 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.md first.

  4. 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.ipynb and assets/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.

More from the pack OpenAI skills

ASP.NET Core apps

Guides the agent through current ASP.NET Core practice: choosing Blazor, Razor Pages, MVC or Minimal APIs, Program.cs and middleware order, auth, EF Core, tests and upgrades to .NET 10. Use when building, reviewing or upgrading an ASP.NET Core app.

ChatGPT Apps SDK

Builds ChatGPT apps on the Apps SDK: reads current OpenAI docs first, picks an app archetype, plans MCP tools, adapts an official example or scaffolds a Node server and widget, then tests in Developer Mode. Use when building or fixing an app inside ChatGPT.

CLI creator from API docs

Builds a durable CLI from API docs, an OpenAPI spec, curls or a script: JSON output, doctor and dry-run commands, safe auth, installed on PATH and paired with a companion skill. Use when an agent keeps hitting the same service through ad hoc calls.

Define a measurable goal

Turns a fuzzy intention into one measurable goal with a validator, scope and stop condition, then registers it via get_goal and create_goal. Use before goal-backed or long-running agent work, when "done" needs a number or a check.

Address GitHub PR comments

Fetches all comments, reviews and inline threads on the current branch's GitHub PR with a gh GraphQL script, numbers them and fixes only the ones you pick. Use when a PR has review comments to work through and you want to choose which get changed.

Fix failing GitHub Actions checks

Finds failing GitHub Actions checks on a PR with gh, pulls the logs, extracts the failure snippet and drafts a fix plan, changing code only after approval. Use when a PR's CI is red and you want the cause and a plan before any edit.

Linear issues and projects

Works with Linear issues, projects and cycles through Linear's MCP server in a fixed order: setup, scope, read, then write, with sample workflows for triage, sprints and releases. Use when an agent should read or update Linear as part of a task.

Deploy to Netlify

Deploys the current project to Netlify with `npx netlify`: checks the login, links the folder to a site by Git remote or creates one, builds locally and returns a preview or production URL. Use when you want to publish a site to Netlify from your machine.

Browser automation with Playwright CLI

Drives a real browser from the terminal with playwright-cli: snapshots give element refs for clicks and typing, plus screenshots, console, network and traces, with no test files written. Use when a task needs a browser clicked through step by step.

Deploy to Render

Deploys an app to Render from a Git repo: writes and validates a render.yaml Blueprint with services, databases and secrets, or creates one service through the Render MCP server, then checks status and logs. Use when an app needs hosting on Render.

Security best-practice review

Checks Python, JavaScript/TypeScript and Go code against bundled security specs for ten frameworks, writes a report by severity with line numbers and fixes one finding at a time. Use when you explicitly ask for a security best-practice review.

Repository threat model

Writes a repository-grounded threat model: trust boundaries, assets, attacker capabilities and ranked abuse paths with mitigations, asking you to confirm key assumptions before the final file. Use when you explicitly ask to threat model a codebase.

Sentry issues and events

Reads Sentry issues and events through the sentry CLI without changing anything: recent production errors, issue and event details, AI root-cause summaries, with PII redacted. Use when you ask what is failing in production according to Sentry.

Deploy to Vercel

Deploys a project to Vercel, as a preview unless told otherwise, through the Vercel CLI or, without an account, a bundled script that uploads the folder and returns a preview link and a claim link. Use when you want a shareable deployment link fast.

Figma MCP design context

Reads Figma frames through the Figma MCP server in a fixed order (design context, metadata, screenshot) and rebuilds them with the project's components and tokens; also covers server setup in Codex. Use when connecting Figma MCP or coding from a frame link.

Figma use_figma prerequisite

Sets the rules an agent must load before every use_figma call that runs Plugin API JavaScript in a Figma file: return values, page resets, colours, fonts, node IDs, small validated steps. Use when creating or editing anything inside a Figma file.

Implement a Figma design in code

Implements a Figma frame or component as code in your repo with 1:1 visual parity: fetches context and a screenshot, maps the output to project tokens and components, then runs a validation checklist. Use when a Figma link must become production UI.

Generate a Figma design from an app

Builds or updates a full screen in Figma from code or a description, section by section, using the file's published components, variables and styles instead of hardcoded values. Use when a page from your app should exist as a Figma screen.

Figma design system from a codebase

Builds a Figma design system library from a codebase in five supervised phases: discovery, variables and styles, page structure, components one by one, QA. Use when a product needs a Figma library that matches its code tokens and components.

Figma Code Connect components

Links published Figma components to the code components that implement them via Code Connect: finds unmapped ones, matches them in the codebase, maps only what the user approves. Use when a Figma library and its code both exist but are not linked.

Figma design system rules

Writes project rules for turning Figma designs into code into CLAUDE.md, AGENTS.md or a Cursor rules file, based on Figma's rule template and an analysis of the codebase. Use when setting up an agent for regular Figma-to-code work in a repo.

Create a new Figma file

Creates a blank Figma design file or FigJam board in your drafts, resolving the plan through whoami, and returns the file key and URL. Use when the next Figma step needs a fresh file to write into.