notebook-ml-architect

Audit Jupyter notebooks for reproducibility and production-readiness issues.

5|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/BjornMelin/dev-skills --skill notebook-ml-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notebook-ml-architect
Source: https://github.com/BjornMelin/dev-skills/tree/main/skills/notebook-ml-architect
Command: npx skills add https://github.com/BjornMelin/dev-skills --skill notebook-ml-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nbformat, papermill, nbclient, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Expert guidance for auditing, refactoring, and designing machine learning Jupyter notebooks with production-quality patterns. Use when: (1) Analyzing notebook structure and identifying anti-patterns, (2) Detecting data leakage and reproducibility issues, (3) Refactoring messy notebooks into modular pipelines, (4) Generating templates for ML workflows (EDA, classification, experiments), (5) Adding reproducibility instrumentation (seeding, logging, env capture), (6) Converting notebooks to Python scripts, (7) Generating experiment summary reports. Triggers on: ML notebook, Jupyter audit, notebook refactor, data leakage, experiment template, ipynb best practices, notebook to script, reproducibility.

Core Features & Use Cases

  • Audit notebooks for anti-patterns, leakage, modularization, and reproducibility gaps.
  • Refactor notebooks into modular Python pipelines and generate template notebooks for common ML workflows (EDA, preprocessing, training, evaluation).
  • Generate reproducibility instrumentation and templates (seeding, environment capture, reporting) and convert notebooks to Python scripts.

Quick Start

Provide an ML notebook and choose an operation (audit, refactor, template, report, or convert) to begin producing a production-ready artifact.

Frequently Asked Questions about notebook-ml-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Jupyter notebooks to Python scripts for reproducibility?

To audit ML notebooks for data leakage, you analyze the notebook structure to detect anti-patterns and reproducibility issues, checking data preprocessing and model training steps for improper data flow.

What is the best way to add reproducibility instrumentation to ML workflows?

You convert Jupyter notebooks to Python scripts by applying a conversion operation that transforms the notebook cells into structured, modular Python code, enabling better reproducibility and pipeline execution.

Do I need papermill and nbclient to generate ML experiment templates?

The best way to add reproducibility instrumentation to ML workflows is by generating templates that enforce seeding, environment capture, and logging, ensuring consistent experiment tracking across EDA and model training.

Can I generate templates for EDA and classification workflows from existing notebooks?

Generating ML experiment templates and executing refactored workflows relies on dependencies like papermill and nbclient to parameterize and run notebooks programmatically, ensuring structured and automated pipeline execution.

Why should I audit ipynb files before moving ML models to production?

You can generate templates for EDA, classification, and other ML workflows by applying a templating operation to your existing notebooks, producing standardized structures for data preprocessing and model training.

How do I refactor a Jupyter notebook into a production-ready ML pipeline?

You should audit ipynb files before production to identify data leakage, modularization gaps, and reproducibility issues, ensuring the notebook is structured as a reliable pipeline rather than an exploratory script.