# Jupyter Notebook

Creates and edits Jupyter notebooks from templates for experiments and tutorials.

- Repository: https://github.com/microsoft/ai-agents-for-beginners (78611 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/ai-agents-for-beginners --skill jupyter-notebook -g -a claude-code -y`
Codex: `npx skills add microsoft/ai-agents-for-beginners --skill jupyter-notebook -g -a codex -y`
Cursor: `npx skills add microsoft/ai-agents-for-beginners --skill jupyter-notebook -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/ai-agents-for-beginners --skill jupyter-notebook -g -a gemini-cli -y`

## Description

Kasuta, kui kasutaja palub luua, üles ehitada või redigeerida Jupyteri märkmikke (`.ipynb`) katsetuste, uurimiste või juhendite jaoks; eelista kaasasolevaid malle ja käivita abiskript `new_notebook.py`, et genereerida puhas algne märkmik.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Jupyter Notebooki oskus

Loo puhtaid, reprodutseeritavaid Jupyter-märkmikke kahe peamise režiimi jaoks:

- Eksperimendid ja avastuslik analüüs
- Õpetused ja õpetamisele suunatud samm-sammult juhendid

Eelista kaasasolevaid malle ja abiskripti ühtlase struktuuri ja vähem JSON-vigade saavutamiseks.

## Millal kasutada
- Loo uus `.ipynb` märkmik nullist.
- Muuda toored märkmed või skriptid struktureeritud märkmikuks.
- Refaktoreeri olemasolev märkmik, et see oleks reprodutseeritavam ja kiiremini läbitav.
- Loo eksperimente või õpetusi, mida teised saavad lugeda või uuesti käivitada.

## Otsustuspuu
- Kui päring on avastuslik, analüütiline või hüpoteesikeskne, vali `experiment`.
- Kui päring on juhendav, samm-sammult või sihtrühmale suunatud, vali `tutorial`.
- Kui redigeerid olemasolevat märkmikku, käsitle seda kui refaktoreerimist: säilita eesmärk ja paranda struktuuri.

## Oskuse rada (määratakse üks kord)

```bash
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`).

## Töövoog
1. Lukusta eesmärk.
Tuvasta märkmiku liik: `experiment` või `tutorial`.
Kirjuta üles eesmärk, sihtrühm ja kuidas näeb välja "valmis".

2. Skafoldi mallist.
Kasuta abiskripti, et vältida märkmiku JSON-i käsitsi kirjutamist.

```bash
uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
  --kind experiment \
  --title "Compare prompt variants" \
  --out output/jupyter-notebook/compare-prompt-variants.ipynb
```

```bash
uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
  --kind tutorial \
  --title "Intro to embeddings" \
  --out output/jupyter-notebook/intro-to-embeddings.ipynb
```

The rest: https://github.com/microsoft/ai-agents-for-beginners/blob/HEAD/translations/et/.agents/skills/jupyter-notebook/SKILL.md