# 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

Verwenden Sie, wenn der Benutzer darum bittet, Jupyter-Notebooks (`.ipynb`) für Experimente, Erkundungen oder Tutorials zu erstellen, aufzusetzen oder zu bearbeiten; bevorzugen Sie die mitgelieferten Vorlagen und führen Sie das Hilfsskript `new_notebook.py` aus, um ein sauberes Start-Notebook zu erzeugen.

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

# Jupyter Notebook-Fähigkeit

Erstelle saubere, reproduzierbare Jupyter-Notebooks für zwei Hauptmodi:

- Experimente und explorative Analyse
- Tutorials und lehrorientierte Schritt-für-Schritt-Anleitungen

Bevorzuge die mitgelieferten Vorlagen und das Hilfsskript für eine konsistente Struktur und weniger JSON-Fehler.

## Wann verwenden
- Erstelle ein neues `.ipynb`-Notebook von Grund auf.
- Konvertiere grobe Notizen oder Skripte in ein strukturiertes Notebook.
- Überarbeite ein vorhandenes Notebook, um es reproduzierbarer und übersichtlicher zu machen.
- Baue Experimente oder Tutorials, die von anderen gelesen oder erneut ausgeführt werden.

## Entscheidungsbaum
- Wenn die Anfrage explorativ, analytisch oder hypothesengetrieben ist, wähle `experiment`.
- Wenn die Anfrage instruktiv, schrittweise oder zielgruppenspezifisch ist, wähle `tutorial`.
- Wenn du ein bestehendes Notebook bearbeitest, behandle es als Refaktorierung: erhalte die Absicht und verbessere die Struktur.

## Fähigkeitenpfad (einmal festlegen)

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

## Arbeitsablauf
1. Absicht festlegen.
Identifiziere die Notebook-Art: `experiment` oder `tutorial`.
Erfasse das Ziel, die Zielgruppe und wie "fertig" aussieht.

2. Gerüst aus der Vorlage erstellen.
Verwende das Hilfsskript, um zu vermeiden, das rohe Notebook-JSON manuell zu erstellen.

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