interactive-notebook

Co-author Quarto notebooks iteratively through Jupyter kernels in Python or R.

1|Updated Oct 25, 2020
One-click install
npx skills add https://github.com/bfairkun/dotfiles --skill interactive-notebook-bfairkun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: interactive-notebook
Source: https://github.com/bfairkun/dotfiles/tree/main/agents/.agents/skills/interactive-notebook
Command: npx skills add https://github.com/bfairkun/dotfiles --skill interactive-notebook-bfairkun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building an analysis notebook interactively often leaves the notebook file out of sync with what was actually run, loses session context after interruptions, and hides plots from the user. This Skill provides a structured workflow for iteratively co-authoring a Quarto (.qmd) notebook with the user while keeping code, plots, and session state synchronized. ## Core Features & Use Cases - Notebook skeleton creation: Generates dated, descriptive .qmd skeletons for Python or R with Quarto YAML frontmatter and standard setup chunks. - Kernel-based exploration loop: Runs exploratory code in a Jupyter kernel (compute-node by default), saves plots as PDF to an agent_plots directory, and writes only validated chunks back into the notebook. - Session checkpointing and recovery: Saves state.md and state.json snapshots of kernel id, namespace, and next steps so the session survives context compaction and can be restored. - Use Case: A data scientist asks the agent to explore a gene expression dataset in R; the agent opens a compute-node kernel, iterates on plots visible to the user via a local URL, and incrementally builds a polished Quarto notebook. ## Quick Start Ask the agent to start an interactive Quarto notebook exploring your dataset in Python or R, iterating on plots together before writing each validated cell into the .qmd file.

Frequently Asked Questions about interactive-notebook

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

FAQPage Schema
How do I build a Quarto notebook interactively with an AI agent?▼

The agent creates a dated .qmd skeleton, opens a Jupyter kernel, and follows a run-show-discuss-refine loop. Each validated code chunk is written back into the notebook incrementally, with plots saved as PDFs you can view in the browser.

Can I use this workflow with both Python and R kernels?▼

Yes, the workflow supports both Python and R Jupyter kernels. R sessions use the same run_python tool channel since the kernel itself is R, and both languages have dedicated session-state checkpoint helpers.

How does the notebook session survive context compaction?▼

The agent writes state.md and state.json checkpoint files capturing the kernel id, key variables with shapes, imports, and next steps. After compaction it reconnects to the same kernel and verifies sentinel variables before continuing.

Why are plots saved as PDF instead of PNG?▼

PDF preserves vector graphics, making plots suitable for inspection and publication. PNG or other formats are only used when the user explicitly requests them.

When should the Quarto notebook be rendered to HTML?▼

Rendering is the final step only, done when the user wants polished HTML output. During exploration a lightweight preview script renders prose without executing cells, so the half-written notebook can still be reviewed.