jupyter-to-marimo

Convert Jupyter notebooks to Marimo notebooks using uvx marimo convert.

2|Updated Nov 24, 2024
One-click install
npx skills add https://github.com/DanSnow/dotfiles --skill jupyter-to-marimo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jupyter-to-marimo
Source: https://github.com/DanSnow/dotfiles/tree/main/private_dot_claude/skills/jupyter-to-marimo
Command: npx skills add https://github.com/DanSnow/dotfiles --skill jupyter-to-marimo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the conversion of Jupyter notebooks into Marimo notebooks, enabling a more efficient and token-conscious workflow for interactive data analysis and presentation.

Core Features & Use Cases

  • Automated Conversion: Converts .ipynb files to .py files compatible with Marimo.
  • Pre-conversion Optimization: Employs uvx marimo convert to minimize token usage before processing.
  • Post-conversion Validation & Refinement: Includes steps for checking converted files, fixing issues, and manually cleaning up artifacts like stray Jupyter magic commands or incorrect display logic.
  • Use Case: You have a complex Jupyter notebook with extensive visualizations and data processing steps. This Skill helps you quickly convert it to a Marimo notebook, making it easier to share and iterate on, while also optimizing for token efficiency during the conversion process.

Quick Start

Convert the attached notebook 'my_analysis.ipynb' to a Marimo notebook named 'my_analysis.py'.

Frequently Asked Questions about jupyter-to-marimo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Jupyter notebook to a Marimo notebook?

You can convert a Jupyter notebook to a Marimo notebook by running a conversion command that transforms the .ipynb file into a .py file, followed by guided manual checks to fix stray Jupyter magic commands and refine display logic.

What is the best way to optimize Jupyter notebook conversion for token usage?

The best way to optimize Jupyter notebook conversion for token usage is using the `uvx marimo convert` command, which minimizes token consumption during the translation process before you manually validate and clean up the resulting Marimo notebook.

Do I need the marimo CLI tool to convert .ipynb files?

Yes, you need the marimo CLI tool available via `uvx` to convert .ipynb files. The Skill relies on this command-line interface to execute the initial notebook format translation and pre-conversion optimization.

Why does my converted Marimo notebook have incorrect display logic?

Your converted Marimo notebook may have incorrect display logic or stray Jupyter magic commands because automated conversion leaves artifacts. The Skill guides you through post-conversion validation to manually clean up these specific issues.

Can I use this to convert complex Jupyter notebooks with visualizations to Marimo?

Yes, you can convert complex Jupyter notebooks with extensive visualizations and data processing steps to Marimo. The process handles the initial translation and then assists in manually refining the converted file for sharing and iteration.