Agent skill

Add Molab Badge

by marimo-team in marimo-team/skills

Add "Open in molab" badge(s) linking to marimo notebooks. An agent skill from marimo-team/skills.

Apache-2.0Auto-check passedData & Analytics

Install Add Molab Badge

skills CLI
$ npx skills add marimo-team/skills --skill add-molab-badge -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install marimo-team/skills add-molab-badge --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/marimo-team/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/add-molab-badge .claude/skills/add-molab-badge && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-molab-badge
GitHub stars
175
Token cost
~1.1k tokens
SKILL.md length
489 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Add "Open in molab" badge(s) linking to marimo notebooks. An agent skill from marimo-team/skills.

  • Works in 6 steps: Session export for molab → Determine the notebook links → Construct the molab URL → …
  • Tasks that involve Jupyter notebooks
  • SKILL.md covers Instructions and Examples
  • Calls uvx and git; reaches marimo.io and molab.marimo.io

What it does

Add Molab Badge is an agent skill from marimo-team/skills. Add "Open in molab" badge(s) linking to marimo notebooks. Works with READMEs, docs, websites, or any markdown/HTML target.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics, covering Jupyter notebooks and Technical documentation. It works with marimo, WebAssembly and GitHub. The repository describes itself as: skills for coding agents related to marimo. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Jupyter notebooks
  • Tasks that involve Technical documentation

Example prompts

  • “Open in molab”
  • “/add-molab-badge”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Session export for molab
  2. Determine the notebook links
  3. Construct the molab URL
  4. Apply the /wasm suffix rules
  5. Format the badge
  6. Insert or replace badges in the target

What it can do on your machine

Read from SKILL.md and the folder at commit 6454470. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uvx
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • marimo.io
    • molab.marimo.io
    • github.com
    • marimo.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Molab Badge loads about 1.1k tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 489 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from marimo-team/skills at commit 6454470, republished under its Apache-2.0 licence (© marimo-team). 489 words, ~1,124 tokens.

Download SKILL.mdSave it as .claude/skills/add-molab-badge/SKILL.md (or your agent's skills folder).
name
add-molab-badge
description
Add "Open in molab" badge(s) linking to marimo notebooks. Works with READMEs, docs, websites, or any markdown/HTML target.

Add molab badge

Add "Open in molab" badge(s) linking to marimo notebooks. The badge can be added to any target: a GitHub README, documentation site, blog post, webpage, or any other markdown/HTML file.

Instructions

0. Session export for molab

molab previews render much nicer if the github repository has session information around. This can be added via:

bash
uvx marimo export session notebook.py
uvx marimo export session folder/

This executes notebooks and exports their session snapshots, which molab uses to serve pre-rendered notebooks.

Key flags:

  • --sandbox — run each notebook in an isolated environment using PEP 723 dependencies
  • --continue-on-error — keep processing other notebooks if one fails
  • --force-overwrite — overwrite all existing snapshots, even if up-to-date

The user may provide notebook links in one of two ways:

  • User provides links directly. The user pastes URLs to notebooks. Use these as-is — no discovery needed.
  • Notebook discovery (README target only). If the user asks you to add badges to a repository's README and doesn't specify which notebooks, discover them:
    1. Find all marimo notebook files (.py files) in the repository. Use Glob with patterns like **/*.py and then check for the marimo header (import marimo or app = marimo.App) to confirm they are marimo notebooks.
    2. If the README already has links to notebooks (e.g., via marimo.app links or existing badges), replace those.
    3. Otherwise, ask the user which notebooks should be linked.
2. Construct the molab URL

For each notebook, construct the molab URL using this format:

https://molab.marimo.io/github/{owner}/{repo}/blob/{branch}/{path_to_notebook}
  • {owner}/{repo}: the GitHub owner and repository name. Determine from the git remote (git remote get-url origin), the user-provided URL, or by asking the user.
  • {branch}: typically main. Confirm from the repository's default branch.
  • {path_to_notebook}: the path to the .py notebook file relative to the repository root.
Show full SKILL.md (207 more words)Show less
3. Apply the /wasm suffix rules
  • If replacing an existing marimo.app link, append /wasm to the molab URL. This is because marimo.app runs notebooks client-side (WASM), so the molab equivalent needs the /wasm suffix to preserve that behavior.
  • If adding a new badge (not replacing a marimo.app link), do not append /wasm unless the user explicitly requests it.
4. Format the badge

Use the following markdown badge format:

markdown
[![Open in molab](https://marimo.io/molab-shield.svg)](URL)

Where URL is the constructed molab URL (with or without /wasm per the rules above).

For HTML targets, use:

html
<a href="URL"><img src="https://marimo.io/molab-shield.svg" alt="Open in molab" /></a>
5. Insert or replace badges in the target
  • When replacing existing badges or links:
    • Replace marimo.app URLs with the equivalent molab.marimo.io URLs.
    • Replace old shield image URLs (e.g., https://marimo.io/shield.svg or camo-proxied versions) with https://marimo.io/molab-shield.svg.
    • Set the alt text to Open in molab.
    • Preserve surrounding text and structure.
  • Edit the target file in place. Do not rewrite unrelated sections.
  • If the user just wants the badge markdown/HTML (not editing a file), output it directly.

Examples

Replacing a marimo.app badge in a README:

Before:

markdown
[![](https://marimo.io/shield.svg)](https://marimo.app/github.com/owner/repo/blob/main/notebook.py)

After:

markdown
[![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/owner/repo/blob/main/notebook.py/wasm)

Note: /wasm is appended because this replaces a marimo.app link.

Adding a new badge from user-provided links:

User says: "Add molab badges for these notebooks: https://github.com/owner/repo/blob/main/demo.py, https://github.com/owner/repo/blob/main/tutorial.py"

Output:

markdown
[![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/owner/repo/blob/main/demo.py)
[![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/owner/repo/blob/main/tutorial.py)

Note: no /wasm suffix by default for new badges.

© marimo-team, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/add-molab-badge of marimo-team/skills.

Open the folder on GitHubat commit 6454470

Compare with similar skills

Add Molab Badge next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Molab Badge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Molab Badge this skillmarimo-team/skills175—~1.1kAutomated safety check: PassApache-2.0
Wasm Compatibilityericmjl/llamabot1832 repos~1.6kAutomated safety check: PassNone
Opendocsioteverythin/OpenDocs234—~746Automated safety check: NotesMIT
Marimo Paircosanlab/nltools1311 repos~3kAutomated safety check: PassMIT
Create Simple Promptpnp/copilot-prompts893—~2.6kAutomated safety check: PassMIT
Marimo Notebookcosanlab/nltools1314 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Wasm Compatibility

    ericmjl/llamabot

    Check if a marimo notebook is compatible with WebAssembly (WASM) and report any issues.

    183 GitHub starsUsed in 2 repos~1.6k tokens
    Data & AnalyticsAuto-check passed
  • Opendocs

    ioteverythin/OpenDocs

    Generates multi-format documentation (Word, PDF, PPTX, Markdown blog post, JIRA ticket, FAQ, changelog, LaTeX, social snippet, architecture diagram) from a GitHub README, npm package, local Markdown…

    234 GitHub stars~746 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Marimo Pair

    cosanlab/nltools

    Work inside a running marimo notebook's kernel — execute code, create cells, and build a notebook as an artifact.

    131 GitHub starsUsed in 1 repo~3k tokens
    Data & AnalyticsAuto-check passed
  • Create Simple Prompt

    pnp/copilot-prompts

    This skill should be used when the user asks to "create a new prompt sample", "add a new prompt sample", "scaffold a new prompt sample", "create a prompt contribution", "add a prompt", or needs to…

    893 GitHub stars~2.6k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Marimo Notebook

    cosanlab/nltools

    Write a marimo notebook in a Python file in the right format.

    131 GitHub starsUsed in 4 repos~2.1k tokens
    Data & AnalyticsAuto-check passed
  • Marimo Batch

    koaning/gitcharts

    An opintionated skill to prepare a marimo notebook to make it ready for a scheduled run.

    145 GitHub starsUsed in 1 repo~819 tokens
    Data & AnalyticsAuto-check: notes

More from marimo-team/skills

  • Auto Paper Demo

    marimo-team/skills

    Make a demo of a research paper in a marimo notebook fully automatically without extra user input.

    175 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed
  • Implement Paper

    marimo-team/skills

    Implement a research paper as an interactive marimo notebook together with the user.

    175 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Streamlit To Marimo

    marimo-team/skills

    Convert a Streamlit app to a marimo notebook. An agent skill from marimo-team/skills.

    175 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Add Molab Badge

What does Add Molab Badge do?

Add "Open in molab" badge(s) linking to marimo notebooks. An agent skill from marimo-team/skills. Add Molab Badge is an agent skill from marimo-team/skills. Add "Open in molab" badge(s) linking to marimo notebooks.

When should I use Add Molab Badge?

Add Molab Badge fits situations like: tasks that involve Jupyter notebooks; tasks that involve Technical documentation.

How do I install Add Molab Badge in Claude Code?

Run `npx skills add marimo-team/skills --skill add-molab-badge -a claude-code`. Or copy the skill folder (skills/add-molab-badge in marimo-team/skills) into .claude/skills/add-molab-badge in your project. Claude Code loads it when a task matches its description.

How do I install Add Molab Badge in Codex?

Run `npx skills add marimo-team/skills --skill add-molab-badge -a codex`. Or copy the skill folder (skills/add-molab-badge in marimo-team/skills) into .agents/skills/add-molab-badge in your project. Codex loads it when a task matches its description.

Can I use Add Molab Badge in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add marimo-team/skills --skill add-molab-badge -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-molab-badge, .gemini/skills/add-molab-badge, .github/skills/add-molab-badge and .opencode/skills/add-molab-badge in your project.

What does Add Molab Badge need to run?

Going by SKILL.md and its folder, Add Molab Badge needs the command-line tools its instructions call (uvx and git).

Does Add Molab Badge access the network?

SKILL.md names 4 domains. In commands or code: marimo.io, molab.marimo.io, github.com and marimo.app; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Add Molab Badge safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Add Molab Badge use?

Add Molab Badge is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Molab Badge use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Molab Badge?

Skills that share tags, products or a category with Add Molab Badge: Wasm Compatibility (ericmjl/llamabot, 183 stars), Opendocs (ioteverythin/OpenDocs, 234 stars), Marimo Pair (cosanlab/nltools, 131 stars) and Create Simple Prompt (pnp/copilot-prompts, 893 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Molab Badge?

marimo-team (a GitHub organization) maintains it in marimo-team/skills, which has 175 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 19, 2026.

Source: marimo-team/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.