Not in the top 1,000 by GitHub stars
marimo-team/marimo-pair
Drop agents inside running marimo notebook sessions
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/marimo-pair/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
2f1d7fffa506 → 2f1d7fffa506
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 2f1d7fffa506
No earlier version was observed for comparison.
skills/retro-marimo-pair/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Instructions only → After Instructions only
2f1d7fffa506 → 2f1d7fffa506
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → 2f1d7fffa506
No earlier version was observed for comparison.
Verified commit 2f1d7fffa50607dc9d8660cb931f4470707f8697
git clone --filter=blob:none --no-checkout https://github.com/marimo-team/marimo-pair.git .hotskills/marimo-team-marimo-pair && git -C .hotskills/marimo-team-marimo-pair checkout --detach 2f1d7fffa50607dc9d8660cb931f4470707f8697
# Copy each selected skill directory from .hotskills/marimo-team-marimo-pair into .claude/skills/<skill-name>/Heat
0.3- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- marimo-pair
skills/marimo-pair - retro-marimo-pair
skills/retro-marimo-pair
How it works
marimo-pair
When your agent uses it
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. Use when the user wants to start a marimo notebook or pair on an active marimo session.
What it loads into context
Frontmatter
98 tokensAlways available to the agent
SKILL.md
2,824 tokensWhen the skill is activated
Reference documents
7,956 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Required first kernel command
- Connect to a Notebook
- Scratchpad Scope
- Marimo Rules
- The Notebook's Shape
- Writing Notebook Changes
- References
Scripts executed separately
scripts/discover-servers.shscripts/execute-code.sh
Files
../../.claude-plugin/marketplace.jsonasset419 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesSKILL.mdcore11,925 bytesreference/execution-context.mddoc2,894 bytesreference/finding-marimo.mddoc4,370 bytesreference/gotchas.mddoc2,959 bytesreference/notebook-improvements.mddoc4,499 bytesreference/rich-representations.mddoc9,826 bytesscripts/discover-servers.shruns10,451 bytesscripts/execute-code.shruns7,747 bytes../retro-marimo-pair/SKILL.mddoc6,420 bytes../retro-marimo-pair/reference/code-mode-surface.mddoc2,339 bytes
Read SKILL.md
marimo is a reactive Python runtime for building reproducible Python programs
(marimo notebooks). Cells are connected by the variables they define and
reference. Running a cell re-executes dependents in dataflow order. The active
runtime holds the kernel namespace, cell state, and dataflow graph. The
notebook (`.py` file) is the artifact the kernel writes from that state while a
session is running.
A user interacts with the same runtime via a notebook UI with cells, outputs,
and widgets.
**WARNING. The active runtime is the source of truth.** During a session, you
SHOULD NOT modify the associated `.py` file directly. File edits WILL NOT reach
the active kernel or user, and the kernel may overwrite them on save. Use
`marimo._code_mode` (`cm`) for notebook changes. Reading disk is fine, butView the complete source on GitHubretro-marimo-pair
When your agent uses it
Session retrospective for improving marimo-pair and marimo._code_mode. Use when the user wants to analyze friction from a pairing session, identify what went wrong, and brainstorm improvements to the skill docs or the underlying API. Trigger on: "retro", "what went wrong", "improve the skill", "session review", "friction", or /retro-marimo-pair.
What it loads into context
Frontmatter
97 tokensAlways available to the agent
SKILL.md
1,494 tokensWhen the skill is activated
Reference documents
557 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Guard Rails
- Step 1: Session Analysis
- Step 2: Root Cause Discussion
- Step 3: Diagnose & Capture
- Step 4: File or Follow Up
- Key Files Reference
Files
SKILL.mdcore6,420 bytesSKILL.mdcore6,420 bytesreference/code-mode-surface.mddoc2,339 bytes
Read SKILL.md
# Session Retrospective
You are helping a **marimo team member** review a pairing session to find
friction and turn it into improvements. The target is always one or both of:
1. **The marimo-pair skill** (`github://marimo-team/marimo-pair`)
2. **`marimo._code_mode`** — the underlying notebook metaprogramming API
This is a **conversation**, not an automated report. You surface findings,
the user steers which ones matter, and together you decide what to do about
them.
## Guard Rails
View the complete source on GitHubSkills included
- marimo-pair
- retro-marimo-pair
Repository facts
- License
- Apache-2.0
- Created
- Feb 24, 2026
- Last pushed
- Sep 16, 2026
- Forks
- 36
- Open issues
- 8
- Project activity
- Active
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 5, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 16 notes
skills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/retro-marimo-pair/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- 1 broad permissionin 1 file: marimo-pair/SKILL.md:1
- 1 dangerous shell commandin 1 file: marimo-pair/scripts/discover-servers.sh:259
- 38 network referencesin 7 files: marimo-pair/reference/notebook-improvements.md:78 marimo-pair/SKILL.md:37 marimo-pair/reference/execution-context.md:21 and 4 more
- No hidden or obfuscated text
- No instruction overrides
- 2 executable scriptsin 2 files: marimo-pair/scripts/discover-servers.sh:1 marimo-pair/scripts/execute-code.sh:1
- 1 reference to secretsin 1 file: marimo-pair/scripts/execute-code.sh:32
- No requests to vote in Hot
Show all 43 signals by file
skills/marimo-pair/SKILL.md
- Broad permissionsline 1
Bash(bash **/scripts/discover-servers.sh *), Bash(bash **/scripts/execute-code.sh *), Read - Network accessline 37
bash /absolute/path/to/marimo-pair/scripts/execute-code.sh \ --url http://localhost:2718 \ - Network accessline 38
--url http://localhost:2718 \ - Network accessline 59
bash /absolute/path/to/marimo-pair/scripts/execute-code.sh \ --url http://localhost:2718 \ - Network accessline 60
--url http://localhost:2718 \ - Network accessline 68
bash /absolute/path/to/marimo-pair/scripts/execute-code.sh \ --url http://localhost:2718 - <<'PY' - Network accessline 69
--url http://localhost:2718 - <<'PY'
skills/marimo-pair/reference/execution-context.md
- Network accessline 21
[Credential-related source omitted] - Network accessline 33
bash scripts/execute-code.sh --url http://localhost:2718 - <<'PY' - Network accessline 39
bash scripts/execute-code.sh --url http://localhost:2718 /tmp/code.py - Network accessline 59
usual one is restarting marimo on the host with `--host 0.0.0.0`. Running the scripts from Git Bash or PowerShell on the Windows side also works. - **needs jq / curl on PATH** - install them in whichever environment runs the - Network accessline 60
scripts from Git Bash or PowerShell on the Windows side also works. - **needs jq / curl on PATH** - install them in whichever environment runs the scripts. Inside WSL that means the distro, not Windows. - Network accessline 61
- **needs jq / curl on PATH** - install them in whichever environment runs the
skills/marimo-pair/reference/finding-marimo.md
skills/marimo-pair/reference/notebook-improvements.md
- Network accessline 78
# before: useful logic buried in a larger cell objects = pl.read_csv("https://example.com/objects.csv") - Network accessline 79
objects = pl.read_csv("https://example.com/objects.csv") - Network accessline 80
artists = pl.read_csv("https://example.com/artists.csv") - Network accessline 107
@mo.persistent_cache def load_data(): objects = pl.read_csv("https://example.com/objects.csv") - Network accessline 108
def load_data(): objects = pl.read_csv("https://example.com/objects.csv") artists = pl.read_csv("https://example.com/artists.csv") - Network accessline 109
objects = pl.read_csv("https://example.com/objects.csv") - Network accessline 110
artists = pl.read_csv("https://example.com/artists.csv")
skills/marimo-pair/reference/rich-representations.md
- Network accessline 40
[anywidget](https://anywidget.dev) bridges Python and JavaScript via - Network accessline 185
Import JS libraries from [esm.sh](https://esm.sh) — no build step: - Network accessline 188
import * as d3 from "https://esm.sh/d3@7"; - Network accessline 189
import { tableFromIPC } from "https://esm.sh/@uwdata/flechette@2"; - Network accessline 223
import { tableFromIPC } from "https://esm.sh/@uwdata/flechette@2";
skills/marimo-pair/scripts/discover-servers.sh
- Executable scriptline 1
#!/usr/bin/env bash - Network accessline 163
answers_marimo() { curl -sf --connect-timeout 1 --max-time 2 "$1/health" 2>/dev/null | grep -q '"healthy"' - Network accessline 164
curl -sf --connect-timeout 1 --max-time 2 "$1/health" 2>/dev/null | grep -q '"healthy"' - Network accessline 216
[[ -n "$candidate" ]] || continue case "$candidate" in *:*) url="http://[${candidate}]:${port}${base_url}" ;; # IPv6 literal - Network accessline 217
case "$candidate" in *:*) url="http://[${candidate}]:${port}${base_url}" ;; # IPv6 literal *) url="http://${candidate}:${port}${base_url}" ;; - Network accessline 218
*:*) url="http://[${candidate}]:${port}${base_url}" ;; # IPv6 literal - Network accessline 219
*) url="http://${candidate}:${port}${base_url}" ;; - Dangerous shell operationline 259
rm -f "$file"
skills/marimo-pair/scripts/execute-code.sh
- Executable scriptline 1
#!/usr/bin/env bash - Access to secretsline 32
[Credential-related source omitted] - Network accessline 121
session_id="$session" else sessions_resp=$(curl -sf --connect-timeout 5 "${auth_args[@]+"${auth_args[@]}"}" "${base}/api/sessions") || { - Network accessline 122
else sessions_resp=$(curl -sf --connect-timeout 5 "${auth_args[@]+"${auth_args[@]}"}" "${base}/api/sessions") || { echo "Failed to connect to marimo server at ${base}" >&2 - Network accessline 123
sessions_resp=$(curl -sf --connect-timeout 5 "${auth_args[@]+"${auth_args[@]}"}" "${base}/api/sessions") || { - Network accessline 219
;; esac done < <(curl -sN -X POST "${base}/api/kernel/execute" \ - Network accessline 220
esac done < <(curl -sN -X POST "${base}/api/kernel/execute" \ -H "Content-Type: application/json" \ - Network accessline 221
done < <(curl -sN -X POST "${base}/api/kernel/execute" \
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Signal confidence: 43 facts
- Broad permissions in the frontmatter of the SKILL.mdmarimo-pair/SKILL.md:1High confidence
- Network access in code of the SKILL.mdmarimo-pair/SKILL.md:37High confidence
- Network access in code of the SKILL.mdmarimo-pair/SKILL.md:38High confidence
- Network access in code of the SKILL.mdmarimo-pair/SKILL.md:59High confidence
- Network access in code of the SKILL.mdmarimo-pair/SKILL.md:60High confidence
- Network access in code of the SKILL.mdmarimo-pair/SKILL.md:68High confidence
- Network access in code of the SKILL.mdmarimo-pair/SKILL.md:69High confidence
- Network access in code of documentationmarimo-pair/reference/execution-context.md:21Low confidence
- Network access in code of documentationmarimo-pair/reference/execution-context.md:33Low confidence
- Network access in code of documentationmarimo-pair/reference/execution-context.md:39Low confidence
- Network access in prose of documentationmarimo-pair/reference/execution-context.md:59Low confidence
- Network access in prose of documentationmarimo-pair/reference/execution-context.md:60Low confidence
- Network access in prose of documentationmarimo-pair/reference/execution-context.md:61Low confidence
- Network access in prose of documentationmarimo-pair/reference/finding-marimo.md:116Low confidence
- Network access in prose of documentationmarimo-pair/reference/finding-marimo.md:117Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:78Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:79Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:80Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:107Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:108Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:109Low confidence
- Network access in code of documentationmarimo-pair/reference/notebook-improvements.md:110Low confidence
- Network access in prose of documentationmarimo-pair/reference/rich-representations.md:40Low confidence
- Network access in prose of documentationmarimo-pair/reference/rich-representations.md:185Low confidence
- Network access in code of documentationmarimo-pair/reference/rich-representations.md:188Low confidence
- Network access in code of documentationmarimo-pair/reference/rich-representations.md:189Low confidence
- Network access in code of documentationmarimo-pair/reference/rich-representations.md:223Low confidence
- Executable script in code of a file that runsmarimo-pair/scripts/discover-servers.sh:1High confidence
- Network access in code of a file that runsmarimo-pair/scripts/discover-servers.sh:163High confidence
- Network access in code of a file that runsmarimo-pair/scripts/discover-servers.sh:164High confidence
- Network access in code of a file that runsmarimo-pair/scripts/discover-servers.sh:216High confidence
- Network access in code of a file that runsmarimo-pair/scripts/discover-servers.sh:217High confidence
- Network access in code of a file that runsmarimo-pair/scripts/discover-servers.sh:218High confidence
- Network access in code of a file that runsmarimo-pair/scripts/discover-servers.sh:219High confidence
- Dangerous shell operation in code of a file that runsmarimo-pair/scripts/discover-servers.sh:259High confidence
- Executable script in code of a file that runsmarimo-pair/scripts/execute-code.sh:1High confidence
- Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuemarimo-pair/scripts/execute-code.sh:32Low confidence
- Network access in code of a file that runsmarimo-pair/scripts/execute-code.sh:121High confidence
- Network access in code of a file that runsmarimo-pair/scripts/execute-code.sh:122High confidence
- Network access in code of a file that runsmarimo-pair/scripts/execute-code.sh:123High confidence
- Network access in code of a file that runsmarimo-pair/scripts/execute-code.sh:219High confidence
- Network access in code of a file that runsmarimo-pair/scripts/execute-code.sh:220High confidence
- Network access in code of a file that runsmarimo-pair/scripts/execute-code.sh:221High confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Native | Manifest .claude-plugin/marketplace.json | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md skills/marimo-pair/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/marimo-pair/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/marimo-pair/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/marimo-pair/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/marimo-pair/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.