# 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

Usar cuando el usuario solicita crear, estructurar o editar cuadernos Jupyter (`.ipynb`) para experimentos, exploraciones o tutoriales; preferir las plantillas incluidas y ejecutar el script auxiliar `new_notebook.py` para generar un cuaderno inicial limpio.

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

# Habilidad de Jupyter Notebook

Crea notebooks de Jupyter limpios y reproducibles para dos modos principales:

- Experimentos y análisis exploratorio
- Tutoriales y guías orientadas a la enseñanza

Prefiere las plantillas incluidas y el script auxiliar para una estructura coherente y menos errores en JSON.

## Cuándo usar
- Crea un nuevo `.ipynb` notebook desde cero.
- Convierte notas o scripts informales en un notebook estructurado.
- Refactoriza un notebook existente para que sea más reproducible y fácil de revisar.
- Crea experimentos o tutoriales que serán leídos o ejecutados nuevamente por otras personas.

## Árbol de decisiones
- Si la solicitud es exploratoria, analítica o basada en hipótesis, elige `experiment`.
- Si la solicitud es instruccional, paso a paso o dirigida a una audiencia específica, elige `tutorial`.
- Si estás editando un notebook existente, trátalo como una refactorización: conserva la intención y mejora la estructura.

## Ruta de la habilidad (configurar una vez)

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

Las habilidades a nivel de usuario se instalan en `$CODEX_HOME/skills` (por defecto: `~/.codex/skills`).

## Flujo de trabajo
1. Fija la intención.
Identifica el tipo de notebook: `experiment` o `tutorial`.
Registra el objetivo, la audiencia y qué significa "hecho".

2. Estructura a partir de la plantilla.
Usa el script auxiliar para evitar redactar manualmente el JSON bruto del notebook.

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