Skip to content

Simplify workflow - #641

Draft
ngrayluna wants to merge 5 commits into
mainfrom
simplify_workflow
Draft

Simplify workflow#641
ngrayluna wants to merge 5 commits into
mainfrom
simplify_workflow

Conversation

@ngrayluna

@ngrayluna ngrayluna commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Simplifies .agent/ directory:

  • Removes vendor marimo skills
  • Separates one long SKILL.md into smaller, specific .md files (see /references)
  • Adds a shell (prepare-marimo-example.sh) script that:
    • converts *.ipynb notebook to *.py using marimo convert
    • checks it runs with marimo check
    • creates a .md file that states which file was converted, exit code, target .py file the agent should look at
  • Separates, removes deterministic/shell script-able steps (e.g. marimo convert) from SKILLS.md

For the last point, the logic is that we don't need an agent to call a deterministic step since we can easily do this (and for free) with a shell script. Instead, reserve resources for agent to do things that are not easily scriptable.

Copilot AI lite review requested due to automatic review settings August 11, 2026 20:41

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR simplifies the .agents/ skill surface by removing vendored marimo skills, consolidating repo-specific marimo notebook guidance into a single skill with focused reference docs, and moving deterministic conversion/check steps into a shell script plus .gitignore support for temporary conversion artifacts.

Changes:

  • Replaces multiple marimo-related skills with a single marimo-wandb-notebooks skill + targeted reference docs.
  • Adds prepare-marimo-example.sh to script marimo conversion + marimo check output capture.
  • Removes vendored skill content (and Apache-2.0 license files) and updates .gitignore to ignore .conversion/ outputs.

Reviewed changes

Copilot reviewed 26 out of 27 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
.gitignore Ignores marimo conversion debug output directories under examples.
.agents/skills/README.md Updates skill index to point to the consolidated marimo skill and the new script.
.agents/skills/marimo-wandb-notebooks/SKILL.md New consolidated skill documenting repo conventions and review checklist for marimo examples.
.agents/skills/marimo-wandb-notebooks/references/wandb-patterns.md Adds W&B-specific notebook integration patterns (auth, reruns, expected failures).
.agents/skills/marimo-wandb-notebooks/references/marimo-idioms.md Adds marimo idioms and a compact checklist for reactivity, gating, and rendering.
.agents/skills/marimo-wandb-notebooks/references/conversion-cleanup.md Adds post-conversion cleanup checklist for polishing converted notebooks.
.agents/skills/marimo-notebook/SKILL.md Removes vendored marimo notebook guidance skill.
.agents/skills/marimo-notebook/references/WATCHING.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/UI.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/TOP-LEVEL-IMPORTS.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/STATE.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/SQL.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/REACTIVITY.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/PYTEST.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/EXPORTS.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/EXPENSIVE.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/DEPLOYMENT.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/CONFIGURATION.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/COLUMNS.md Removes vendored reference doc.
.agents/skills/marimo-notebook/references/ANYWIDGET.md Removes vendored reference doc.
.agents/skills/marimo-notebook/LICENSE Removes vendored Apache-2.0 license file associated with removed vendored skill.
.agents/skills/marimo-example-notebook/SKILL.md Removes the prior repo-specific marimo example skill in favor of the new consolidated skill.
.agents/skills/jupyter-to-marimo/SKILL.md Removes vendored Jupyter→marimo conversion skill in favor of scripted conversion.
.agents/skills/jupyter-to-marimo/references/widgets.md Removes vendored reference doc.
.agents/skills/jupyter-to-marimo/references/latex.md Removes vendored reference doc.
.agents/skills/jupyter-to-marimo/LICENSE Removes vendored Apache-2.0 license file associated with removed vendored skill.
.agents/scripts/prepare-marimo-example.sh Adds deterministic conversion/check/report generation script for .ipynb → marimo .py.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +72 to +74
module_name="${slug//-/_}"
target_dir="examples/marimo/$slug"
target_py="$target_dir/$module_name.py"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants