# 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

Käytetään, kun käyttäjä pyytää luomaan, alustamaan tai muokkaamaan Jupyter-muistikirjoja (`.ipynb`) kokeita, tutkimuksia tai opetusohjelmia varten; käytä mieluummin mukana olevia mallipohjia ja suorita apuohjelmaskripti `new_notebook.py` luodaksesi puhtaan aloitusmuistikirjan.

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

# Jupyter Notebook -taito

Luo siistejä, toistettavia Jupyter-muistikirjoja kahteen pääasialliseen tilaan:

- Kokeilut ja tutkiva analyysi
- Opetus ja opastetut läpikäynnit

Suosi mukana tulevia malleja ja apuskriptiä yhtenäisen rakenteen ja vähempien JSON-virheiden vuoksi.

## Milloin käyttää
- Luo uusi `.ipynb`-muistikirja alusta alkaen.
- Muunna karkeat muistiinpanot tai skriptit rakenteelliseksi muistikirjaksi.
- Refaktoroi olemassa oleva muistikirja entistä toistettavammaksi ja helposti silmäiltäväksi.
- Rakenna kokeiluja tai opastuksia, joita muut ihmiset lukevat tai suorittavat uudelleen.

## Päätöspuu
- Jos pyyntö on tutkivaa, analyyttistä tai hypoteesikeskeistä, valitse `experiment`.
- Jos pyyntö on opastava, vaiheittainen tai kohderyhmäspezifi, valitse `tutorial`.
- Jos muokkaat olemassa olevaa muistikirjaa, käsittele sitä refaktorointina: säilytä tarkoitus ja paranna rakennetta.

## Taitopolku (määritä kerran)

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

## Työnkulku
1. Vahvista tarkoitus.
Tunnista muistikirjan tyyppi: `experiment` tai `tutorial`.
Kirjaa tavoite, yleisö ja milloin työ on valmis.

2. Luo runko mallista.
Käytä apuskriptiä välttääksesi raakamuotoisen muistikirjan JSON:n käsin kirjoittamisen.

```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/fi/.agents/skills/jupyter-notebook/SKILL.md