Agent skill

Export ML Notebook

by probabl-ai in probabl-ai/skills

Convert a jupytext percent %% Python file into an executed .ipynb with cell outputs.

BSD-3-ClauseAuto-check passedData & Analytics

Install Export ML Notebook

skills CLI
$ npx skills add probabl-ai/skills --skill export-ml-notebook -a claude-code

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

GitHub CLI
$ gh skill install probabl-ai/skills export-ml-notebook --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/probabl-ai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/export-ml-notebook .claude/skills/export-ml-notebook && 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
export-ml-notebook
GitHub stars
135
Token cost
~1k tokens
SKILL.md length
512 words
Files
2
Skills in repo
23
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Convert a jupytext percent %% Python file into an executed .ipynb with cell outputs.

  • Works in 5 steps: python -m skore_skills status. Read… → If policy.notebooks is null: persist → If policy.notebooks is false: say… → …
  • Executed-report requests
  • SKILL.md covers Human-facing prose, Sequence and Stop conditions
  • Calls python, uv and git

What it does

Export ML Notebook is an agent skill from probabl-ai/skills. Convert a jupytext percent %% Python file into an executed .ipynb with cell outputs. Pass --html when the notebook should also become a viewer on the site. Trigger on notebook, ipynb, HTML, or executed-report requests, or when export-ml-project dispatches notebooks.

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

It sits in Data & Analytics, covering Jupyter notebooks. It works with Jupyter, Python and Matplotlib. The repository describes itself as: Tabular Data Science Skills for guardrailing AI Agents. The licence is BSD-3-Clause.

When your agent uses it

  • Executed-report requests
  • Export-ml-project dispatches notebooks

Example prompts

  • “/export-ml-notebook”

Requirements

  • Python 3

Workflow steps

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

  1. python -m skore_skills status. Read policy.notebooks and
  2. If policy.notebooks is null: persist
  3. If policy.notebooks is false: say executed notebooks are
  4. Convert the requested percent file (default data_analysis/data_analysis.py when
  5. After --html, if policy.site is true, export-ml-site

What it can do on your machine

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

    • python
    • uv
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use uv and git, which can reach the network depending on how they are called.

    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

Export ML Notebook loads about 1k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 512 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~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 probabl-ai/skills at commit 5edc7a4, republished under its BSD-3-Clause licence (© probabl-ai). 512 words, ~1,016 tokens.

Download SKILL.mdSave it as .claude/skills/export-ml-notebook/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
export-ml-notebook
description
Convert a jupytext percent `# %%` Python file into an executed `.ipynb` with cell outputs. Pass `--html` when the notebook should also become a viewer on the site. Trigger on notebook, ipynb, HTML, or executed-report requests, or when export-ml-project dispatches notebooks.

Export ML Notebook

Source of truth stays the # %% .py. This skill only writes derived .ipynb (and optional .nb.html). Do not rewrite the .py from the notebook. cells run is not a substitute.

Human-facing prose

Details: setup-workspace references/human_facing_prose.md. Tell the user the written .ipynb (and HTML viewer) paths. Do not quote notebook convert, --html, or site build as something they should run.

While policy.notebooks is true, explore-ml-data converts the analysis file it wrote. model-ml-pipeline and evaluate-ml-pipeline convert the experiment script and, when it exists, audit/<stem>.py. audit-ml-pipeline converts audit/<stem>.py only on a direct close. This skill owns on-demand conversions, other sources, and turning the flag on when it is null or false.

Sequence

  1. python -m skore_skills status. Read policy.notebooks and skills.

  2. If policy.notebooks is null: persist python -m skore_skills policy set notebooks true. Do not AskUserQuestion. Then load add-python-package for jupytext, nbclient, and ipywidgets (agent) and continue.

  3. If policy.notebooks is false: say executed notebooks are off; offer to turn them on. Do not convert until the policy is true.

  4. Convert the requested percent file (default data_analysis/data_analysis.py when the user did not name one):

    bash
    python -m skore_skills notebook convert data_analysis/data_analysis.py

    Convert injects %matplotlib inline for the kernel run so seaborn / matplotlib last expressions emit image/png, then strips that setup cell from the written notebook. Do not put %matplotlib inline in the .py (style / ruff would reject it).

    If convert fails because ipywidgets is missing, load add-python-package for it (agent) and convert again. Missing jupytext / nbclient / nbconvert stays a one-line skip.

    If the user wants the executed notebook on the site, load add-python-package for nbconvert (agent) and pass --html (writes a self-contained <stem>.nb.html next to the .py). The site embeds that file in the associated exploratory data analysis or design report with open-separately and fullscreen controls.

    Optional --out path.ipynb. Keep *.ipynb gitignored unless the user asks setup-git to track them.

    Convert-only requests (executed notebook / ipynb / convert, no HTML or site viewer): run only that notebook convert line, with no --html. Tell the user the written .ipynb path. Do not mention --html or site build as an optional aside.

  5. After --html, if policy.site is true, export-ml-site

Show full SKILL.md (162 more words)Show less

is installed, run python -m skore_skills site build so the viewer is packaged. Run --html and site build only when the user asked for HTML or a site viewer. Convert without --html does not rebuild the site. Skip in one line otherwise. If site build errors with mkdocs-material is required, load add-python-package for mkdocs-material (agent) and build once more. Do not pixi add / uv add. If that skill is missing, or the retry still fails, name the error in one line. Name a build error; do not fail the convert. Point the user at the HTML viewer / report.html, not the CLI.

Stop conditions

  • Do not git commit or git end-turn.
  • Do not run cells run as a substitute for convert.
  • Do not pixi add / uv add; load add-python-package.
  • Missing skill or missing source → one-line skip.
  • Do not name --html or python -m skore_skills site build unless the user asked for HTML or a site viewer. Tell the user paths, not the CLI.

© probabl-ai, BSD-3-Clause. 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 skills/export-ml-notebook of probabl-ai/skills.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 5edc7a4

Compare with similar skills

Export ML Notebook 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.

Export ML Notebook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Export ML Notebook this skillprobabl-ai/skills135—~1kAutomated safety check: PassBSD-3-Clause
Release Evidence WorkflowAli-Marandi/ClimateDataAnalyzer107—~1.6kAutomated safety check: PassMIT
Save Research Notebooknapjon/krisk118—~702Automated safety check: PassBSD-3-Clause
Analytics Data AnalysisMindrally/skills267—~1.6kAutomated safety check: PassApache-2.0
Jupyter Live KernelRedWoodOG/Hermes-Desktop1775 repos~1.4kAutomated safety check: PassMIT
Jupyter Live Kerneltaracodlabs/aiden849—~949Automated safety check: PassApache-2.0

Similar skills

  • Release Evidence Workflow

    Ali-Marandi/ClimateDataAnalyzer

    Build an auditable release-evidence workflow for a desktop or packaged application.

    107 GitHub stars~1.6k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Convert a completed data-analysis conversation into evidence-backed, reproducible living research through the Krisk MCP server.

    118 GitHub stars~702 tokensUpdated 6 days ago
    Data & AnalyticsAuto-check passed
  • Analytics Data Analysis

    Mindrally/skills

    Best practices for analytics, data analysis, and visualization using Python, pandas, matplotlib, seaborn, and Jupyter notebooks.

    267 GitHub stars~1.6k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Jupyter Live Kernel

    RedWoodOG/Hermes-Desktop

    Use a live Jupyter kernel for stateful, iterative Python execution via hamelnb.

    177 GitHub starsUsed in 5 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • Jupyter Live Kernel

    taracodlabs/aiden

    Stateful Jupyter kernel — variables persist across cells (hamelnb)

    849 GitHub stars~949 tokensUpdated 24 days ago
    Data & AnalyticsAuto-check passed
  • Builds reproducible Quarto reports, presentations, and websites across R, Python, and Julia, with correct engine selection, cache-vs-freeze semantics, native cross-references, parameters, and…

    1.2k GitHub starsUsed in 1 repo~2.4k tokens
    Data & AnalyticsAuto-check passed

More from probabl-ai/skills

All 23 skills in this repo
  • Add Python Package

    probabl-ai/skills

    Add a Python dependency through the project env manager, or ask the user to install it when env.managed is false.

    135 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Build ML Pipeline

    probabl-ai/skills

    Declare the pipeline from data source to predictor as a skrub DataOps graph.

    135 GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • Evaluate ML Pipeline

    probabl-ai/skills

    Evaluate one learner with skore.evaluate. An agent skill from probabl-ai/skills.

    135 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Setup Workspace

    probabl-ai/skills

    Detect an existing ML workspace or scaffold a fresh one via python -m skoreskills scaffold --package <pkg.

    135 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Audit ML Pipeline

    probabl-ai/skills

    Read-only audit of one persisted skore report: audit/NN<stem.py (jupytext percent), 1:1 with experiments/ and journal/.

    135 GitHub stars~9.5k tokensUpdated yesterday
    Auto-check passed
  • Explore ML Data

    probabl-ai/skills

    Owns data understanding before any model is designed. An agent skill from probabl-ai/skills.

    135 GitHub stars~5.7k tokensUpdated yesterday
    Auto-check passed

Questions about Export ML Notebook

What does Export ML Notebook do?

Convert a jupytext percent %% Python file into an executed .ipynb with cell outputs. Export ML Notebook is an agent skill from probabl-ai/skills.ipynb with cell outputs.

When should I use Export ML Notebook?

Export ML Notebook fits situations like: executed-report requests; export-ml-project dispatches notebooks.

How do I install Export ML Notebook in Claude Code?

Run `npx skills add probabl-ai/skills --skill export-ml-notebook -a claude-code`. Or copy the skill folder (skills/export-ml-notebook in probabl-ai/skills) into .claude/skills/export-ml-notebook in your project. Claude Code loads it when a task matches its description.

How do I install Export ML Notebook in Codex?

Run `npx skills add probabl-ai/skills --skill export-ml-notebook -a codex`. Or copy the skill folder (skills/export-ml-notebook in probabl-ai/skills) into .agents/skills/export-ml-notebook in your project. Codex loads it when a task matches its description.

Can I use Export ML Notebook 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 probabl-ai/skills --skill export-ml-notebook -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/export-ml-notebook, .gemini/skills/export-ml-notebook, .github/skills/export-ml-notebook and .opencode/skills/export-ml-notebook in your project.

What does Export ML Notebook need to run?

Going by SKILL.md and its folder, Export ML Notebook needs the command-line tools its instructions call (python, uv and git). Our summary lists: Python 3.

Does Export ML Notebook access the network?

SKILL.md contains no URLs. Its commands use uv and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Export ML Notebook 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 Export ML Notebook use?

Export ML Notebook is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Export ML Notebook use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Export ML Notebook?

Skills that share tags, products or a category with Export ML Notebook: Release Evidence Workflow (Ali-Marandi/ClimateDataAnalyzer, 107 stars), Save Research Notebook (napjon/krisk, 118 stars), Analytics Data Analysis (Mindrally/skills, 267 stars) and Jupyter Live Kernel (RedWoodOG/Hermes-Desktop, 177 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Export ML Notebook?

probabl-ai (a GitHub organization) maintains it in probabl-ai/skills, which has 135 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 6, 2026.

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