preview

Installation
SKILL.md

Preview

Render and deploy project documents, reports, and notebooks using Quarto.

Usage

If _quarto.yml or .github/workflows/docs.yml is missing, complete the setup sections below first.

Push the branch. CI renders and deploys automatically. PR preview URLs: https://<owner>.github.io/<repo>/pr-preview/pr-<number>/ (private repos use an obfuscated domain but the same path structure). Check CI status with gh run list / gh run view.

For local preview: quarto preview (hot reloads). One-time build: quarto render.

Quarto Project Setup

If the project doesn't have a _quarto.yml yet, confirm the plan with the user, then:

  1. Check which quarto. If not installed locally, see https://quarto.org/docs/get-started/ — or use the Workspace skill to get a devcontainer with Quarto pre-installed.
  2. Copy assets/_quarto.yml to the project root and adjust the title.
  3. Create an index.qmd with YAML frontmatter (title: at minimum). Use .qmd for all documents — it's Quarto's canonical format and required for full tooling support.
Related skills
Installs
37
GitHub Stars
13
First Seen
Mar 30, 2026