Jupyter Notebook Executor
Apps & Automationjupyter-notebook-executorJupyter Notebook Executor is an Agent Skill for apps & automation published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Jupyter notebook execution skill for running notebooks programmatically and extracting outputs.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/data-science-ml/skills/jupyter-notebook-executor/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/jupyter-notebook-executor, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
jupyter-notebook-executor
Overview
Jupyter notebook execution skill for running notebooks programmatically, parameterizing inputs, and extracting outputs for ML workflows.
Capabilities
- Parameterized notebook execution
- Output extraction and validation
- Notebook conversion (to HTML/PDF)
- Cell execution control
- Error handling and reporting
- Environment management
- Kernel specification
- Timeout management
Target Processes
- Exploratory Data Analysis (EDA) Pipeline
- Model Interpretability and Explainability Analysis
- Experiment Planning and Hypothesis Testing
Tools and Libraries
- papermill
- nbconvert
- jupyter
- nbformat
Input Schema
{
"type": "object",
"required": ["action", "notebookPath"],
"properties": {
"action": {
"type": "string",
"enum": ["execute", "convert", "extract", "validate"],
"description": "Action to perform on the notebook"
},
"notebookPath": {
"type": "string",
"description": "Path to the Jupyter notebook"
},
"executeConfig": {
"type": "object",
"properties": {
"parameters": { "type": "object" },
"outputPath": { "type": "string" },
"kernel": { "type": "string" },
"timeout": { "type": "integer" },
"cwd": { "type": "string" }
}
},
"convertConfig": {
"type": "object",
"properties": {
"format": { "type": "string", "enum": ["html", "pdf", "markdown", "script"] },
"outputPath": { "type": "string" },
"template": { "type": "string" },
"excludeInput": { "type": "boolean" },
"excludeOutput": { "type": "boolean" }
}
},
"extractConfig": {
"type": "object",
"properties": {
"cellTags": { "type": "array", "items": { "type": "string" } },
"outputTypes": { "type": "array", "items": { "type": "string" } },
"variableNames": { "type": "array", "items": { "type": "string" } }
}
}
}
}
Output Schema
{
"type": "object",
"required": ["status", "action"],
"properties": {
"status": {
"type": "string",
"enum": ["success", "error", "timeout"]
},
"action": {
"type": "string"
},
"executionResult": {
"type": "object",
"properties": {
"outputPath": { "type": "string" },
"executionTime": { "type": "number" },
"cellsExecuted": { "type": "integer" },
"errors": { "type": "array" }
}
},
"conversionResult": {
"type": "object",
"properties": {
"outputPath": { "type": "string" },
"format": { "type": "string" }
}
},
"extractedData": {
"type": "object",
"properties": {
"variables": { "type": "object" },
"outputs": { "type": "array" },
"figures": { "type": "array", "items": { "type": "string" } }
}
}
}
}
Usage Example
{
kind: 'skill',
title: 'Execute EDA notebook with parameters',
skill: {
name: 'jupyter-notebook-executor',
context: {
action: 'execute',
notebookPath: 'notebooks/eda_template.ipynb',
executeConfig: {
parameters: {
data_path: 'data/train.csv',
output_dir: 'results/eda/',
sample_size: 10000
},
outputPath: 'notebooks/eda_results.ipynb',
kernel: 'python3',
timeout: 3600
}
}
}
}