compile

name	compile
description	Compile any supported file type. Detects format (.typ, .qmd, .py) and runs appropriate build command.
argument-hint	[filename]
allowed-tools	["Read","Bash","Glob"]

Compile Document

Detect file format and run the appropriate build command.

Format Detection

Determine file type from extension:

• .typ → Typst document
• .qmd → Quarto slides
• .py → Python script

Note: For .tex (LaTeX/Beamer), configure compilation at project level with project-specific TEXINPUTS and bibtex paths.

Compilation Commands

For .typ files (Typst):

typst compile [--root ..] FILENAME.typ

• Use --root if the file imports packages from a parent directory
• Check exit code for compilation errors
• Typst compilation is single-pass (no multi-pass needed)

For .qmd files (Quarto):

quarto render FILENAME.qmd

• Or use project-specific deploy script if available

For .py files (Python):

uv run FILENAME.py

• Check exit code
• Verify output files were created (if applicable)

Post-Compilation Checks

1. Check for warnings:

   • .typ: Check stderr for warnings
   • .qmd: Check for render warnings
   • .py: Check for tracebacks or warnings

2. Verify output exists and has non-zero file size

3. Visual spot-check (.typ files only):

   • Render sample pages to PNG: typst compile FILE.typ /tmp/preview-{0p}.png
   • For documents (>3 pages): render pages 1, middle, and last
   • For presentations: render all slides
   • Use Read tool on PNGs to visually inspect for overflow, blank pages, missing figures
   • See typst/references/visual-verification.md for full checklist

4. Report results:

   • Compilation success/failure
   • Warning count
   • Output file path and size
   • Visual check: PASS / issues noted