# 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 Skill

दो मुख्य मोड के लिए साफ़, पुनरुत्पादनीय Jupyter नोटबुक बनाएं:

- प्रयोग और अन्वेषणात्मक विश्लेषण
- ट्यूटोरियल और शिक्षण-उन्मुख विस्तृत मार्गदर्शिकाएँ

सुसंगत संरचना और कम JSON त्रुटियों के लिए बने-बंडल किए गए टेम्पलेट और हेल्पर स्क्रिप्ट का उपयोग करें।

## When to use
- एक नया `.ipynb` नोटबुक शून्य से बनाएं।
- असंरचित नोट्स या स्क्रिप्ट को संरचित नोटबुक में परिवर्तित करें।
- मौजूदा नोटबुक को अधिक पुनरुत्पादनीय और आसानी से स्किम करने योग्य बनाने के लिए रीफैक्टर करें।
- ऐसे प्रयोग या ट्यूटोरियल बनाएं जिन्हें अन्य लोग पढ़ेंगे या फिर से चलाएंगे।

## Decision tree
- यदि अनुरोध अन्वेक्षात्मक, विश्लेषणात्मक, या परिकल्पना-प्रधान है, तो `experiment` चुनें।
- यदि अनुरोध निर्देशात्मक, चरण-दर-चरण, या दर्शक-विशेष है, तो `tutorial` चुनें।
- यदि किसी मौजूदा नोटबुक को संपादित किया जा रहा है, तो इसे रीफैक्टर के रूप में मानें: उद्देश्य बनाए रखें और संरचना में सुधार करें।

## Skill path (set once)

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

## Workflow
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.
टेम्पलेट से ढाँचा तैयार करें।
हैंड-ऑथरिंग के बजाय हेल्पर स्क्रिप्ट का उपयोग करें ताकि कच्चे नोटबुक 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/hi/.agents/skills/jupyter-notebook/SKILL.md
