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)

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.

uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
  --kind experiment \
  --title "Compare prompt variants" \
  --out output/jupyter-notebook/compare-prompt-variants.ipynb

uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
  --kind tutorial \
  --title "Intro to embeddings" \
  --out output/jupyter-notebook/intro-to-embeddings.ipynb