jupyter-to-marimo

This skill automates the conversion of Jupyter notebooks (.ipynb) to marimo notebooks (.py), a modern reactive notebook format. It provides a streamlined workflow that prioritizes efficiency by converting notebooks first before reading them, which can save over 30,000 tokens when working with large notebooks. The conversion process uses the marimo CLI tool via uvx, eliminating the need for manual installation.

The skill goes beyond simple file conversion by including validation and cleanup steps. After the initial conversion using the marimo convert command, it runs marimo check to identify any issues in the generated code. The process then involves manual review to remove Jupyter-specific artifacts like display() calls and magic commands, ensure proper cell expression rendering, and verify that all required packages are listed in the script metadata. Special consideration is given to common migration challenges like environment variable handling, widget compatibility, and LaTeX syntax differences.

This skill is ideal for data scientists and developers who want to migrate their existing Jupyter workflows to marimo's reactive notebook environment. It's particularly valuable for teams transitioning large notebook repositories, educators updating course materials, or individual developers seeking the benefits of marimo's reactive execution model. The skill handles common migration patterns including ipywidgets-to-marimo widget mapping, LaTeX/MathJax-to-KaTeX conversion, and environment configuration setup, making it suitable for notebooks of varying complexity.