# Notebook Executor

> Execute OpenQuant notebook code cells non-interactively, persist outputs to artifact paths, and fail fast on runtime errors. Use when this capability is needed.

- Skill: `tomevault-io/notebook-executor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/notebook-executor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/notebook-executor/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/notebook-executor

---


# Notebook Executor

Use this skill when you need deterministic notebook execution in CI or local verification loops.

## What this skill does

1. Executes `.ipynb` code cells with plain Python.
2. Writes execution counts and stdout/error outputs back to notebook JSON.
3. Supports writing to a separate output path (`--out`) to avoid mutating source notebooks.

## Command

```bash
uv run --python .venv/bin/python notebooks/python/scripts/execute_notebook_cells.py \
  notebooks/python/08_algo_wheel_experiments.ipynb \
  --out /tmp/openquant-artifacts/08_algo_wheel_experiments.executed.ipynb
```

## File targets

- Executor: `notebooks/python/scripts/execute_notebook_cells.py`
- Notebook set: `notebooks/python/*.ipynb`

## Validation

```bash
uv run --python .venv/bin/python pytest python/tests/test_notebook_execute_script.py -q
```

---
> Source: [Open-Quant/openquant](https://github.com/Open-Quant/openquant) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-26 -->