What problem does it solve?
It streamlines converting multiple standalone Quarto lecture files (.qmd) into a single Quarto book project that renders consistently and deploys cleanly to GitHub Pages, avoiding common rendering and branding pitfalls.
Core Features & Use Cases
- Chapter intake & structure proposal: Scans a directory for .qmd files, extracts titles/headings, and proposes a book chapter/part structure for review before writing files.
- Book project generation: Creates or updates
_quarto.yml, ensures an index.qmd exists, and lists chapters in the correct order and grouping.
- Rendering issue prevention (THWS + Quarto correctness): Removes conflicting front YAML blocks from chapter files to avoid duplicate titles, sets up the required
moodle-html extension, and applies fixes for inline SVG header rendering and sidebar stacking/Z-index conflicts.
- Production-ready deployment: Adds a GitHub Actions workflow that renders the project and publishes
_site to GitHub Pages, plus updates .gitignore for Quarto artifacts.
Quick Start
Use the quarto-book-setup skill on a folder of your .qmd chapters and answer the three prompts to generate _quarto.yml, patch the chapters, add GitHub Pages publishing workflow, and get a ready-to-deploy book project.