# Working With Marimo

> Working With Marimo is an Agent Skill for development published in the pymc-labs/CausalPy repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Interactive development in marimo notebooks with validation loops. Use for creating/editing marimo notebooks and verifying execution.

- Skill name: `working-with-marimo`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/pymc-labs/CausalPy/blob/HEAD/.agents/skills/working-with-marimo/SKILL.md
- Repository: pymc-labs/CausalPy (1,162 GitHub stars when collected)

## SKILL.md

# 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](reference/best_practices.md) (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](reference/best_practices.md) for code formatting, reactivity rules, and UI element usage.

---

Source: https://www.openparable.com/skill/development/working-with-marimo (OpenParable). Cite the canonical URL above.
