jupyter-to-marimo

SKILL.md

Convert Jupyter notebooks to marimo Python scripts with CLI-driven transformation and cleanup guidance.

Use uvx marimo convert <notebook.ipynb> -o <notebook.py> to generate marimo-compatible .py files without local installation

Run marimo check before and after manual edits to catch syntax and compatibility issues

Common cleanup tasks include removing Jupyter artifacts (%magic commands, display() calls), verifying package metadata, and ensuring final cell expressions render correctly

Includes reference guides for porting ipywidgets to marimo equivalents, converting MathJax to KaTeX, and adding environment variable configuration via EnvConfig widget

Converting Jupyter Notebooks to Marimo

IMPORTANT: When asked to translate a notebook, ALWAYS run uvx marimo convert <notebook.ipynb> -o <notebook.py> FIRST before reading any files. This saves precious tokens - reading large notebooks can consume 30k+ tokens, while the converted .py file is much smaller and easier to work with.

Steps

Convert using the CLI

Run the marimo convert command via uvx so no install is needed:

uvx marimo convert <notebook.ipynb> -o <notebook.py>

This generates a marimo-compatible .py file from the Jupyter notebook.

Run marimo check on the output