new-notebook

Create date-prefixed Quarto analysis notebooks with Python or R kernels and structured prose conventions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new analysis often leads to inconsistent notebook naming, missing context, and undocumented methodology that collaborators cannot follow. This Skill enforces a consistent convention for creating analysis notebooks so every exploration is reproducible, readable, and properly organized. ## Core Features & Use Cases - Standardized Naming and Structure: Creates date-prefixed notebooks (YYYYMMDD_descriptive_name.qmd) in the analysis/ directory with correct Quarto YAML headers for Python (py_general kernel) or R kernels. - Prose-First Documentation: Enforces writing conventions where notebooks open with the research question, introduce every plot and table, justify methodological choices, and close with conclusions. - Path and Output Conventions: Directs data access through relative paths and routes small outputs to output/ and large files to code/scratch/. - Use Case: When starting a new exploration like splice site conservation analysis, invoke this Skill to scaffold a properly named Quarto notebook with the right kernel, setup chunks, and documentation structure, then render it with render_notebook. ## Quick Start Create a new analysis notebook for exploring differential gene expression results using the Python kernel.

Frequently Asked Questions about new-notebook

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

FAQPage Schema
How do I create a new Quarto analysis notebook?▼

Invoke this Skill with a brief description of the analysis. It creates a date-prefixed .qmd file in the analysis/ directory with the correct YAML header, kernel configuration, and setup chunks for Python or R.

How to set up a Python kernel for Quarto notebooks?▼

Use the py_general conda environment as the Jupyter kernel in the Quarto YAML header. Register it first with conda run -n py_general python -m ipykernel install --user --name py_general if needed.

Can I use R instead of Python in these notebooks?▼

Yes, the Skill supports R kernels through Quarto with knitr or the Quarto R engine. It provides the appropriate YAML header and a setup chunk loading tidyverse and data.table.

Where should notebook data files and outputs go?▼

Use paths relative to the analysis/ directory, such as ../data/ for inputs. Small tables and figures go to output/ for committing, while large files go to code/scratch/ which is not committed.

How do I render a Quarto notebook after creating it?▼

Run render_notebook render analysis/YYYYMMDD_name.qmd from the project root or analysis directory. This quarto shim records the render environment into a hidden block in the .qmd file.