quarto-book-setup

Convert standalone .qmd lecture files into a deployable Quarto book.

Updated May 10, 2026
One-click install
npx skills add https://github.com/c-kraus/thws-skills --skill quarto-book-setup-c-kraus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quarto-book-setup
Source: https://github.com/c-kraus/thws-skills/tree/main/quarto-book-setup
Command: npx skills add https://github.com/c-kraus/thws-skills --skill quarto-book-setup-c-kraus

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about quarto-book-setup

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

FAQPage Schema
How do I convert standalone .qmd lecture files into a single Quarto book?

To convert standalone .qmd files into a Quarto book, this skill scans your directory, proposes a chapter structure, generates the _quarto.yml configuration, and patches chapter front YAML to ensure consistent rendering.

How do I deploy a Quarto book to GitHub Pages using GitHub Actions?

Deploying a Quarto book to GitHub Pages requires a GitHub Actions workflow that renders the project and publishes the _site directory. This skill automatically adds this workflow to your repository.

Why does my Quarto book have duplicate titles or broken sidebar layouts?

Duplicate titles and broken sidebar layouts in a Quarto book often result from conflicting front YAML blocks. This skill removes these conflicts and applies fixes for inline SVG header rendering and sidebar Z-index stacking.

Can I use the moodle-html extension with Quarto for lecture publishing?

Yes, you can use the moodle-html extension with Quarto for lecture publishing. This skill enforces the THWS-branded moodle-html format and automatically adds the required extension to your book project.

What is the best way to structure multi-file Quarto lectures into parts and chapters?

The best way to structure multi-file Quarto lectures is to scan the .qmd files to extract titles and headings, allowing you to propose a logical book chapter and part structure before writing any configuration files.