# jupyter-notebooks

This skill builds, edits, and checks repeatable SQL or Python notebooks. Use it when an analysis must be readable, rerunnable, and easy to audit.

- skill · `type=skill` · Codex, ChatGPT · ★ 7604
- Author: Data Analytics Maintainers · official OpenAI repository
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openai/plugins/tree/HEAD/plugins/data-analytics/skills/jupyter-notebooks/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/jupyter-notebooks

## What it does

The skill treats a Jupyter notebook as a reader-facing analysis artifact. It can shape reports, experiments, diagnostics, data-quality checks, and tutorials, while keeping data loading, preparation, calculations, charts, and interpretation in a clear sequence.

For existing files, it preserves the original intent and limits structural churn. Notebook-aware tools such as JupyterLab, `nbformat`, and `nbclient` are supported for setup and validation. SQL may stay in SQL cells or separate query files, while assumptions, parameters, and source references remain visible beside the work.

Validation runs every cell in order with `python -m jupyter nbconvert --execute --to notebook --inplace path/to/notebook.ipynb`. The notebook cannot be checked this way unless the execution environment has the required kernel, dependencies, and data.

## Install

### Codex (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill jupyter-notebooks -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/jupyter-notebooks/SKILL.md` — For all projects use ~/.agents/skills/

### Claude Code

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill jupyter-notebooks -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/jupyter-notebooks/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/jupyter-notebooks/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/jupyter-notebooks/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins jupyter-notebooks
```

2. **Manually: put the files in place**
- File: `.github/skills/jupyter-notebooks/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/jupyter-notebooks
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/jupyter-notebooks/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/openai/plugins/tree/HEAD/plugins/data-analytics/skills/jupyter-notebooks/SKILL.md

## When to use it
- build a repeatable Jupyter notebook for analysis
- separate SQL, Python, data preparation, and charts
- run notebook cells in a consistent order
- keep sources, parameters, and assumptions with the analysis
- refactor an existing notebook with limited structural changes

## Example prompts
- Create `analysis.ipynb` for a repeatable SQL and Python analysis, with clear sections and an execution check.
- Run `analysis.ipynb` from the first cell to the last, connect the conclusions to cell outputs, and list the steps needed to reproduce the check.
- Edit `report.ipynb` while preserving its purpose, then separate data preparation from charting.

## Similar
- [jupyter-notebook](https://affpapa.org/en/nevibecode/skills/jupyter-notebook.md) — skill · 5600 installs
- [jupyter-to-marimo](https://affpapa.org/en/nevibecode/skills/jupyter-to-marimo.md) — skill · 3400 installs
- [data-analysis-jupyter](https://affpapa.org/en/nevibecode/skills/data-analysis-jupyter.md) — skill · 1500 installs
- [jupyter-mcp-server](https://affpapa.org/en/nevibecode/mcp/jupyter-mcp-server.md) — MCP server · ★ 9
- [dt-app-notebooks](https://affpapa.org/en/nevibecode/skills/dt-app-notebooks.md) — skill · 2700 installs
- [data-jupyter-python](https://affpapa.org/en/nevibecode/skills/data-jupyter-python.md) — skill · 865 installs

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 528 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md