# 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

Použijte, když uživatel požádá o vytvoření, inicializaci nebo úpravu Jupyter notebooků (`.ipynb`) pro experimenty, průzkumy nebo návody; upřednostněte zabudované šablony a spusťte pomocný skript `new_notebook.py`, abyste vygenerovali čistý výchozí notebook.

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

# Dovednost Jupyter Notebook

Vytvářejte čisté, reprodukovatelné Jupyter notebooky pro dva hlavní režimy:

- Experimenty a průzkumné analýzy
- Tutoriály a výukové průvodce

Upřednostněte dodané šablony a pomocný skript pro konzistentní strukturu a méně chyb v JSONu.

## Kdy použít
- Vytvořte nový `.ipynb` notebook od začátku.
- Převeďte hrubé poznámky nebo skripty do strukturovaného notebooku.
- Přepracujte existující notebook tak, aby byl více reprodukovatelný a přehledný.
- Vytvářejte experimenty nebo tutoriály, které budou čteny nebo znovu spouštěny jinými lidmi.

## Rozhodovací strom
- Pokud je požadavek průzkumný, analytický nebo založený na hypotéze, zvolte `experiment`.
- Pokud je požadavek instruktážní, krok za krokem nebo zaměřený na konkrétní publikum, zvolte `tutorial`.
- Při úpravě existujícího notebooku jej považujte za refaktorizaci: zachovejte záměr a vylepšete strukturu.

## Cesta dovednosti (nastavit jednou)

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

## Pracovní postup
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.

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