# 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

Използвайте, когато потребителят иска да създаде, да изгради основна структура за или да редактира Jupyter тетрадки (`.ipynb`) за експерименти, изследвания или уроци; предпочитайте вградените шаблони и стартирайте помощния скрипт `new_notebook.py`, за да генерирате чист начален файл на тетрадка.

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

# Умение за Jupyter Notebook

Създавайте чисти, възпроизводими Jupyter бележници за два основни режима:

- Експерименти и изследователски анализ
- Уроци и ръководства, ориентирани към обучение

Предпочитайте вградените шаблони и помощния скрипт за последователна структура и по-малко грешки в JSON.

## Кога да използвате
- Създайте нов `.ipynb` бележник от нулата.
- Конвертирайте неполни бележки или скриптове в структуриран бележник.
- Рефакторирайте съществуващ бележник, за да бъде по-възпроизводим и лесен за преглед.
- Създавайте експерименти или уроци, които ще бъдат прочетени или преизпълнени от други хора.

## Дърво на решенията
- Ако заявката е изследователска, аналитична или хипотетично-ориентирана, изберете `experiment`.
- Ако заявката е инструктивна, стъпка по стъпка или насочена към конкретна аудитория, изберете `tutorial`.
- Ако редактирате съществуващ бележник, третирайте го като рефакториране: запазете намерението и подобрете структурата.

## Път на умението (за настройка веднъж)

```bash
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
```

Потребителските умения се инсталират под `$CODEX_HOME/skills` (по подразбиране: `~/.codex/skills`).

## Работен процес
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/bg/.agents/skills/jupyter-notebook/SKILL.md