notebook-debugger

Diagnose and fix failing Jupyter notebooks using a structured troubleshooting workflow.

6|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/dangeles/claude --skill notebook-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notebook-debugger
Source: https://github.com/dangeles/claude/tree/main/claude-config/skills/notebook-debugger
Command: npx skills add https://github.com/dangeles/claude --skill notebook-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users to diagnose and fix failing Jupyter notebooks by applying a formal, repeatable troubleshooting workflow that covers kernel crashes, import errors, and memory issues.

Core Features & Use Cases

  • Structured troubleshooting workflow: Follows Diagnose → Isolate → Fix → Verify → Document phases to resolve notebook failures.
  • Environment and kernel hygiene: Checks for correct Python environments, registered Jupyter kernels, and reproducible dependencies to ensure notebooks run in stable contexts.
  • Memory and performance diagnostics: Provides guidance on memory profiling, chunking, and memory-safe data handling to prevent crashes on large datasets.
  • Reproducibility and documentation: Emphasizes end-to-end execution on fresh kernels and produces setup guidance to support reproducibility across machines.

Quick Start

Open a failing notebook and follow the diagnostic workflow: restart the kernel, run all cells in displayed order, perform memory and import checks, apply the recommended fixes (reorganize cells, add dependency checks, enforce execution order, and document environment), then verify reproducibility with a fresh environment by performing a full Restart & Run All.

Frequently Asked Questions about notebook-debugger

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

FAQPage Schema
How do I fix a Jupyter notebook that crashes the kernel when running large datasets?

To fix a Jupyter notebook kernel crash on large datasets, this skill guides you through memory profiling, chunking, and memory-safe data handling to isolate and resolve memory exhaustion. It enforces structured diagnostics to identify whether memory limits or execution order cause the failure.

What is the best way to troubleshoot import errors in a Jupyter notebook?

The best way to troubleshoot Jupyter notebook import errors is to validate the active Python environment and check registered Jupyter kernels. This skill enforces environment validation and reproducibility checks to ensure dependencies are correctly installed and accessible across data science projects.

How do I ensure my Jupyter notebook reproduces results on a fresh kernel?

To ensure Jupyter notebook reproducibility on a fresh kernel, perform a full Restart & Run All after applying fixes. This skill verifies end-to-end execution on fresh kernels and produces setup documentation to support consistent environments across machines.

Why does my Jupyter notebook fail when I run cells out of order?

Your Jupyter notebook fails when cells run out of order due to hidden state dependencies and missing variable definitions. This skill helps you reorganize cells, enforce execution order, and verify notebook stability through a structured isolation and verification workflow.

Can I use this troubleshooting workflow for data science projects with complex dependencies?

Yes, you can use this troubleshooting workflow for data science projects with complex dependencies. It checks for correct Python environments, registered Jupyter kernels, and reproducible dependencies to ensure notebooks run in stable contexts across analytics projects.