notebook-debug

Inspect .ipynb files for tracebacks and cell execution issues.

19|5|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/edwinhu/workflows --skill notebook-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notebook-debug
Source: https://github.com/edwinhu/workflows/tree/main/skills/notebook-debug
Command: npx skills add https://github.com/edwinhu/workflows --skill notebook-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users understand and resolve runtime errors within executed Jupyter notebooks, regardless of their origin.

Core Features & Use Cases

  • Traceback Analysis: Identifies and interprets error messages and tracebacks from notebook outputs.
  • Cell Execution Verification: Ensures all notebook cells have executed correctly and in the proper order.
  • Use Case: When a data science notebook fails during execution, this skill helps pinpoint the exact cell causing the error and provides the necessary context to fix it.

Quick Start

Use the notebook-debug skill to inspect the execution outputs of the attached file 'analysis.ipynb'.

Frequently Asked Questions about notebook-debug

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

FAQPage Schema
How do I debug runtime errors in an executed Jupyter notebook?

To debug Jupyter notebook runtime errors, inspect the `.ipynb` file for tracebacks and cell execution issues. This process identifies the exact failing cell and extracts the error context needed to resolve the execution failure.

Why does my executed notebook fail when running through papermill or jupytext?

Executed notebook failures through papermill or jupytext often stem from cell execution issues or hidden tracebacks. Inspecting the `.ipynb` file outputs verifies whether all cells executed correctly and in the proper order to pinpoint the error.

Do I need jq installed to inspect Jupyter notebook tracebacks?

Yes, you need `jq` installed to perform quick checks for tracebacks within `.ipynb` files. It enables fast querying of notebook outputs, while the `Read` tool handles detailed inspection of specific cell errors and execution issues.

What is the best way to verify if all notebook cells executed correctly?

The best way to verify notebook cell execution is to inspect the `.ipynb` file outputs for tracebacks. This checks that all cells executed correctly and in the proper sequence, highlighting any runtime errors that disrupted the pipeline.

Can I use this approach to debug marimo notebook execution issues?

Yes, you can debug marimo notebook execution issues by inspecting the executed notebook files. This approach applies to failed executions from various sources including marimo, extracting tracebacks to pinpoint the exact cell causing the runtime error.

What should I do when my data science notebook throws a traceback during execution?

When a data science notebook throws a traceback during execution, inspect the `.ipynb` file outputs to locate the error. Analyzing the traceback identifies the exact failing cell and provides the necessary context to fix the issue.