# 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

Gunakan saat pengguna meminta untuk membuat, membangun kerangka, atau mengedit notebook Jupyter (`.ipynb`) untuk eksperimen, eksplorasi, atau tutorial; utamakan templat bawaan dan jalankan skrip pembantu `new_notebook.py` untuk menghasilkan notebook awal yang bersih.

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

# Keterampilan Jupyter Notebook

Buat notebook Jupyter yang bersih dan dapat direproduksi untuk dua mode utama:

- Eksperimen dan analisis eksploratori
- Tutorial dan panduan berorientasi pengajaran

Utamakan template bawaan dan skrip pembantu untuk struktur yang konsisten dan lebih sedikit kesalahan JSON.

## Kapan digunakan
- Buat notebook `.ipynb` baru dari awal.
- Konversi catatan kasar atau skrip menjadi notebook yang terstruktur.
- Refaktor notebook yang ada agar lebih dapat direproduksi dan mudah dibaca.
- Bangun eksperimen atau tutorial yang akan dibaca atau dijalankan ulang oleh orang lain.

## Pohon keputusan
- Jika permintaan bersifat eksploratori, analitis, atau berorientasi hipotesis, pilih `experiment`.
- Jika permintaan bersifat instruksional, langkah-demi-langkah, atau spesifik audiens, pilih `tutorial`.
- Jika mengedit notebook yang sudah ada, perlakukan sebagai refaktor: pertahankan maksud dan perbaiki struktur.

## Jalur keterampilan (atur sekali)

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

## Alur kerja
1. Kunci tujuan.
Identifikasi jenis notebook: `experiment` atau `tutorial`.
Catat tujuan, audiens, dan seperti apa "selesai".

2. Buat kerangka dari template.
Gunakan skrip pembantu untuk menghindari menulis JSON notebook mentah secara manual.

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