Book cover. Title: Prompt, Check, Publish. Subtitle: Reproducible Data Publishing with Quarto and AI Coding Agents. Author: Ravi Kalia. A box labelled .qmd branches into eight coloured lines that end in html, pdf, docx, epub, slides, website, blog and dashboard.

A practitioner’s guide

Prompt,
Check,
Publish

Reproducible Data Publishing with Quarto and AI Coding Agents

Write once. Let an agent write the code. Check it. Publish to eight formats.

  • EPUB
  • Web
  • no sign-up
QR code: https://project-delphi.github.io/quarto-workshop/ebook/
Scan to open this pageproject-delphi.github.io/quarto-workshop/ebook

The method

One loop, every step

You ask, you check, Quarto rebuilds. Every hands-on step in the book goes once round this loop, so a mistake is caught while it is still small.

  1. Prompt

    Describe one small piece of work to a coding agent, with its files and columns named.

  2. Check

    Read what changed, look at the result, compare it with the data. An agent can be fluent, fast and wrong, so this step is never skipped, and it is always yours.

  3. Publish

    Quarto rebuilds every output from the checked source, the same way every time.

Two real projects

What you’ll build

Both run on real, cited data: no toy tables pretending to be research.

A 3-D map of central London that tilts and turns: the boroughs in muted tones, the Thames in blue between them, five columns at the five sights, as tall as their visits, the Natural History Museum's tallest, and ten short markers at Visit London's churches.
The five sights and Visit London's churches on the London boroughs, turning. Visits: ALVA; places: Wikidata; boroughs: ONS, Open Government Licence v3.0, contains OS data © Crown copyright and database right 2024.

Part II · London

A visitor guide for London

7,116,929visits in 2025 to the Natural History Museum (South Kensington), the most of London’s ten most visited ALVA member attractions

One guide becomes a web page, a Word brief for partners, a printed flyer, a dashboard for managers and a published website.

Turn the live 3-D mapRead Part II

A map of mainland Colombia seen from above, with coloured columns at municipal centroids, tilting so the columns rise to their head towns' altitude: the tallest columns run along the Andes in the centre and west, the shortest along the Caribbean coast and in the east, and the view then flies into the highlands.
Clustered urban zones as columns at their head towns' altitude, coloured by cluster, tilting up and flying into the highlands.

Part V · Colombia

Drinking-water risk in Colombia

1,122municipalities and areas, every one of DANE’s DIVIPOLA entries, urban and rural, 2010–2023

Group municipal zones into kinds with k-means, compare health and education between them, and publish the analysis as a report, slides, a blog post and a website, all from one analysis script.

Step through k-meansRead Part V

This page was built the way the book teaches

This page is a Quarto document. When it is built, code reads the book’s data, chapter list and cover, so every number on it, the contents below and the fan of formats above come from the book’s source, not from typing. Change the data, rebuild, and the page changes with it. This is the function behind the London number:

def london_top() -> dict:
    import pandas as pd

    att = pd.read_csv(ROOT / "examples/london/data/attractions.csv")
    visits_col = next(c for c in att.columns if c.startswith("visits_"))
    top = att.loc[att[visits_col].idxmax()]
    return {"name": top["attraction"], "visits": int(top[visits_col]),
            "year": visits_col.removeprefix("visits_"), "n": len(att)}

This page’s source The code that reads the book

Who it’s for

For people who publish numbers that change

  • Analysts
  • Researchers
  • Data scientists
  • Machine-learning engineers
  • Technical founders
  • Educators
  • Students

Anyone who works with data or code and needs to share the results. If you already use a terminal and Git, the fast path takes you from there to a report in three formats in under an hour; if not, the route from zero sets up your computer first. No programming is assumed: the book explains the Python the agent writes, but you do not have to write it.

What you need

Three things

  1. A computer on which you can install software: Windows, Mac or Linux.
  2. A free GitHub account.
  3. An account with one coding agent.

An honest note on cost: Claude Code, for one, needs a paid plan or pay-per-use billing (checked 2026-11-18). Chapter 4 lists what each agent needs.

Inside the book

What a page looks like

A three-part box from Chapter 7: Ask your coding agent, with the prompt; Expect it to run; You do.
Every hands-on step is a three-part box: the exact prompt to give your agent, what it will probably run, and the few things only you can do.
A Try it box from Chapter 6 that ends with a one-line catch-up prompt naming a checkpoint's README.
Stuck for two minutes? One line to your agent brings the project to the chapter's checkpoint, and you carry on from there.
Horizontal bar chart of 2025 visits to ten London attractions, longest bar at the top: the Natural History Museum is highest and Royal Museums Greenwich lowest.
Visits in 2025 to London's ten most visited ALVA member attractions. Every chart has a caption and alt text, which say different things.Alt text: Horizontal bar chart of 2025 visits to ten London attractions, longest bar at the top: the Natural History Museum is highest and Royal Museums Greenwich lowest.
The EPUB on a phone in night mode, opening Chapter 7, which quotes 7,116,929 visits.
The EPUB at night on a phone. Chapter 7 opens with the same 7,116,929 visits, computed from the same file.

The workshop

Run it as a six-hour workshop

The book is the written edition of a six-hour, hands-on workshop. Its slides are online, and its worked examples and catch-up checkpoints are in the repository, so you can follow along alone or teach it.

About the author

Ravi Kalia

Ravi Kalia holds a PhD in statistical machine learning from the University of Oxford and has spent twenty years working with data, in several industries and on many continents.

This book is the written edition of Ravi’s hands-on Quarto workshop. The workshop’s slides are online, and its worked examples and catch-up checkpoints are in its GitHub repository.

Ravi Kalia on LinkedIn

Questions

Before you download

Is it really free?

Yes. Download the EPUB or read the website edition: there is no sign-up and no email to give.

How do I open it on my phone?
  • In LinkedIn’s, Instagram’s or another app’s browser, the download often fails. Open this page in Safari or Chrome first: tap ⋯ or ⋮, then Open in browser.
  • On an iPhone or iPad: once it has downloaded, open it (Safari: tap ⬇ beside the address; Chrome: tap Open in… at the bottom). If Books does not open, use the share sheet (Safari: tap Share first): tap Books in the row of apps or, if it is not there, swipe that row to its end and tap More.
  • On Android: you need a reading app such as Google Play Books (free). Once it has downloaded, tap Open. If the phone cannot open it, find the book in Files → Downloads, long-press it, then Open with → Play Books.
Which agent do I need?

One coding agent. Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account; Codex a ChatGPT sign-in or an API key; Antigravity a Google account (checked 2026-11-18). Chapter 2 explains how to choose, and what a conversation costs.

Does it work on Windows?

Yes: Windows, Mac or Linux. On Windows you first install Ubuntu with WSL; Appendix A and the workshop’s Windows page take you through it, one checked step at a time.

How current is it?

The first edition, of November 2026, was checked with Quarto 1.10.20. Prices, versions, screens and plans are given with the date they were checked, and will change.

Can I teach with it?

Yes: teach from the free book and slides, link to them, and follow Appendix I to run the workshop. To copy or adapt the material, ask the author first.

How was it written?

With an AI coding agent, as the book teaches. From the book’s AI usage statement:

This book was written with Claude Code (Claude Opus 5.5), which drafted the chapters, code, diagrams and media scripts and rendered both editions, adapting the workshop slides, which were themselves written with Claude Code (Claude Opus 5.5, Sonnet 5.5, Opus 5 and Fable 5.1). Every number drawn from the projects’ data is computed from that data when the book is built; prices, timings and other facts that change are cited with the date they were checked. The author directed the work and takes full responsibility for the content.

Get the book

Free. The EPUB for your e-reader, or the website edition with the live 3-D scenes.