jupyter-notebook

Use when the user asks to create, scaffold, or edit Jupyter notebooks (.ipynb) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script new_notebook.py to generate a clean starting notebook.

1. Ustaw zmienną środowiskową JUPYTER_NOTEBOOK_CLI, wskazującą na skrypt new_notebook.py. Domyślnie umiejętność instaluje się w ~/.codex/skills/jupyter-notebook/scripts/new_notebook.py. Jeśli używasz niestandardowej ścieżki CODEX_HOME, dostosuj ją odpowiednio.

2. Określ cel notebooka: czy będzie to eksperyment (analiza, testowanie hipotez) czy tutorial (instrukcje dla odbiorcy). Ta decyzja wpłynie na strukturę i styl zawartości.

3. Uruchom skrypt pomocniczy z parametrami --kind (experiment lub tutorial), --title (nazwa notebooka) i --out (ścieżka wyjściowa). Na przykład: uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" --kind experiment --title "Porównanie wariantów promptu" --out output/jupyter-notebook/

4. Skrypt wygeneruje czysty, gotowy do użytku notebook JSON, unikając błędów ręcznego formatowania. Notebook będzie zawierać wstępną strukturę komórek dostosowaną do wybranego trybu.

5. Otwórz wygenerowany plik .ipynb w Jupyter Lab lub Jupyter Notebook i uzupełnij zawartość (kod, wyjaśnienia, wyniki). Jeśli edytujesz istniejący notebook, użyj tej umiejętności do refaktoryzacji — zachowaj intencję, popraw strukturę.

6. Jeśli notebook będzie czytany przez innych lub uruchamiany wielokrotnie, upewnij się, że komórki są logicznie pogrupowane i zawierają wyjaśnienia. Umiejętność wspiera ten przepływ poprzez konsekwentne szablony.