notebook-writer

Generate Jupytext-based Markdown notebooks for reproducible analyses.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps researchers and data scientists create well-structured, reproducible Jupyter notebooks that document calculations, workflows, and results in a git-friendly format.

Core Features & Use Cases

  • Generate Jupytext-based Markdown notebooks with clear narrative and code cells.
  • Provide templates and workflows for parameter sweeps, data analysis, and reproducible reporting.
  • Enable end-to-end reproducibility by documenting environment and dependencies and offering easy conversion to IPYNB.

Quick Start

Create a Markdown notebook following the examples in the skill guide, then convert to IPYNB using python3 -m jupytext --to ipynb notebook.md and run it in Jupyter. This workflow keeps notebooks human-readable and version-controlled.

Frequently Asked Questions about notebook-writer

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

FAQPage Schema
How do I create reproducible Jupyter notebooks for version control?

You can create reproducible Jupyter notebooks by writing Jupytext-based Markdown files with clear narrative and code cells, then converting them to IPYNB format using python3 -m jupytext --to ipynb. This keeps notebooks human-readable and git-friendly for collaboration.

What is literate programming for data analysis in Markdown notebooks?

Literate programming for data analysis combines narrative documentation and executable code within Markdown notebooks. This skill generates well-structured Jupytext files that document calculations, workflows, and parameterized sweeps for transparent, reproducible reporting.

Can I convert Markdown notebooks to IPYNB for reproducible research?

Yes, you can convert Markdown notebooks to IPYNB format by running python3 -m jupytext --to ipynb notebook.md. This workflow enables end-to-end reproducibility by maintaining a human-readable source file while producing standard Jupyter outputs.

How do I document dependencies and environments for reproducible data analysis?

To document dependencies for reproducible data analysis, this skill provides templates that explicitly record the environment and dependencies alongside parameterized workflows. This ensures calculations and results can be recreated and verified.

Does Jupytext work with parameter sweeps and reproducible reporting?

Yes, Jupytext works with parameter sweeps by providing structured templates within Markdown notebooks. These templates support parameterized workflows and clear narrative documentation, enabling reproducible reporting for data scientists and researchers.

What's the best way to keep Jupyter notebooks git-friendly for collaboration?

The best way to keep Jupyter notebooks git-friendly is authoring them as Jupytext Markdown files. This format tracks changes clearly in version control, avoiding large binary outputs, and easily converts to IPYNB for execution.