Agent skill

Working With Marimo

by pymc-labs in pymc-labs/CausalPy

Interactive development in marimo notebooks with validation loops.

Apache-2.0Auto-check passedData & Analytics

Install Working With Marimo

skills CLI
$ npx skills add pymc-labs/CausalPy --skill working-with-marimo -a claude-code

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

GitHub CLI
$ gh skill install pymc-labs/CausalPy working-with-marimo --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/pymc-labs/CausalPy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/working-with-marimo .claude/skills/working-with-marimo && 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
working-with-marimo
GitHub stars
1.2k
Token cost
~357 tokens
SKILL.md length
108 words
Files
2
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Interactive development in marimo notebooks with validation loops.

  • Works in 3 steps: Context & Plan → Execute → Verify (CRITICAL)
  • Creating/editing marimo notebooks and verifying execution
  • SKILL.md covers Feedback Loop, Common Commands and Reference
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Working With Marimo is an agent skill from pymc-labs/CausalPy. Interactive development in marimo notebooks with validation loops. Use for creating/editing marimo notebooks and verifying execution.

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `reference/best_practices.md`).

It sits in Data & Analytics, covering Jupyter notebooks. It works with marimo and Model Context Protocol. The repository describes itself as: A Python package for causal inference in quasi-experimental settings. The licence is Apache-2.0.

When your agent uses it

  • Creating/editing marimo notebooks and verifying execution
  • Tasks that involve Jupyter notebooks

Example prompts

  • “/working-with-marimo”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Context & Plan
  2. Execute
  3. Verify (CRITICAL)

What it can do on your machine

Read from SKILL.md and the folder at commit f17b30f. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Working With Marimo loads about 357 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 108 words of instructions outside code blocks.

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

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 pymc-labs/CausalPy at commit f17b30f, republished under its Apache-2.0 licence (© pymc-labs). 108 words, ~357 tokens.

Download SKILL.mdSave it as .claude/skills/working-with-marimo/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
working-with-marimo
description
Interactive development in marimo notebooks with validation loops. Use for creating/editing marimo notebooks and verifying execution.

Working with Marimo

Follows a Plan-Execute-Verify loop to ensure notebook correctness.

Feedback Loop

  1. Context & Plan:

    • Sessions: mcp_marimo_get_active_notebooks (Find session IDs).
    • Structure: mcp_marimo_get_lightweight_cell_map (See cell IDs/content).
    • Data State: mcp_marimo_get_tables_and_variables (Inspect DataFrames/Variables).
    • Cell Detail: mcp_marimo_get_cell_runtime_data (Code, errors, local vars).
  2. Execute:

    • Edit the .py file directly using write or search_replace.
    • Rule: Follow Best Practices (e.g., @app.cell, no global state).
  3. Verify (CRITICAL):

    • Lint: mcp_marimo_lint_notebook (Static analysis).
    • Runtime Errors: mcp_marimo_get_notebook_errors (Execution errors).
    • Outputs: mcp_marimo_get_cell_outputs (Visuals/Console).

Common Commands

  • Start/Sync: Marimo automatically syncs file changes.
  • SQL: Use mo.sql for DuckDB queries.
  • Plots: Use plt.gca() or return figure. No plt.show().

Reference

See Best Practices for code formatting, reactivity rules, and UI element usage.

© pymc-labs, 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

SKILL.md and 1 other file in .agents/skills/working-with-marimo of pymc-labs/CausalPy.

  • SKILL.md
  • reference/best_practices.md

Open the folder on GitHubat commit f17b30f

Compare with similar skills

Working With Marimo 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.

Working With Marimo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Working With Marimo this skillpymc-labs/CausalPy1.2k—~357Automated safety check: PassApache-2.0
Wasm Compatibilityericmjl/llamabot1832 repos~1.6kAutomated safety check: PassNone
Marimo Paircosanlab/nltools1311 repos~3kAutomated safety check: PassMIT
Marimo Notebookcosanlab/nltools1314 repos~2.1kAutomated safety check: PassMIT
Marimo Batchkoaning/gitcharts1451 repos~819Automated safety check: NotesNone
Marimo PairPhySpace/SimpleCADAPI142—~3kAutomated safety check: PassApache-2.0

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
  • 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
  • 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
  • Marimo Pair

    PhySpace/SimpleCADAPI

    Drive a live marimo notebook as a workspace: run Python in the same kernel the user does, inspect live notebook state, and commit durable notebook changes.

    142 GitHub stars~3k tokensUpdated 7 days ago
    Data & AnalyticsAuto-check passed
  • Marimo Pair Vscode

    marimo-team/marimo-lsp

    Drive a live marimo notebook in VS Code as a workspace: run Python in the same kernel the user does, inspect and explore live notebook state and data, prototype and debug code, and commit durable…

    131 GitHub stars~2.7k tokensUpdated today
    Data & AnalyticsAuto-check passed

More from pymc-labs/CausalPy

All 12 skills in this repo
  • Example Datasets

    pymc-labs/CausalPy

    Load built-in CausalPy example datasets for demos, tutorials, tests, and quick causal-analysis prototypes.

    1.2k GitHub stars~587 tokensUpdated today
    Auto-check passed
  • Review PR

    pymc-labs/CausalPy

    Review CausalPy pull requests end-to-end by classifying PR type, checking branch freshness, mergeability, remote CI, correctness, security, tests, docs, and maintainer concerns.

    1.2k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Causal Detective

    pymc-labs/CausalPy

    Challenge causal claims through structured threat assessment, counterfactual reasoning, and CausalPy falsification checks.

    1.2k GitHub stars~809 tokensUpdated today
    Auto-check passed
  • Running Placebo Analysis

    pymc-labs/CausalPy

    Performs placebo-in-time sensitivity analysis with hierarchical null model and optional Bayesian assurance.

    1.2k GitHub starsUsed in 1 repo~442 tokens
    Auto-check passed
  • Python Environment

    pymc-labs/CausalPy

    Detect, configure, and use the project's Python environment (uv by default, conda-compatible tool as a fallback).

    1.2k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Feature Exploration

    pymc-labs/CausalPy

    Explore unfamiliar APIs, libraries, or implementation behavior with minimal reproducible examples and documented findings.

    1.2k GitHub stars~442 tokensUpdated today
    Auto-check passed

Questions about Working With Marimo

What does Working With Marimo do?

Interactive development in marimo notebooks with validation loops. Working With Marimo is an agent skill from pymc-labs/CausalPy. Interactive development in marimo notebooks with validation loops.

When should I use Working With Marimo?

Working With Marimo fits situations like: creating/editing marimo notebooks and verifying execution; tasks that involve Jupyter notebooks.

How do I install Working With Marimo in Claude Code?

Run `npx skills add pymc-labs/CausalPy --skill working-with-marimo -a claude-code`. Or copy the skill folder (.agents/skills/working-with-marimo in pymc-labs/CausalPy) into .claude/skills/working-with-marimo in your project. Claude Code loads it when a task matches its description.

How do I install Working With Marimo in Codex?

Run `npx skills add pymc-labs/CausalPy --skill working-with-marimo -a codex`. Or copy the skill folder (.agents/skills/working-with-marimo in pymc-labs/CausalPy) into .agents/skills/working-with-marimo in your project. Codex loads it when a task matches its description.

Can I use Working With Marimo 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 pymc-labs/CausalPy --skill working-with-marimo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/working-with-marimo, .gemini/skills/working-with-marimo, .github/skills/working-with-marimo and .opencode/skills/working-with-marimo in your project.

What does Working With Marimo need to run?

SKILL.md names no scripts, command-line tools or credentials: Working With Marimo is instructions for the agent only.

Does Working With Marimo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Working With Marimo 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 Working With Marimo use?

Working With Marimo 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 Working With Marimo use?

About 357 tokens (SKILL.md is roughly 1.4k 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 Working With Marimo?

Skills that share tags, products or a category with Working With Marimo: Wasm Compatibility (ericmjl/llamabot, 183 stars), Marimo Pair (cosanlab/nltools, 131 stars), Marimo Notebook (cosanlab/nltools, 131 stars) and Marimo Batch (koaning/gitcharts, 145 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Working With Marimo?

pymc-labs (a GitHub organization) maintains it in pymc-labs/CausalPy, which has 1,201 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

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