# Translate To Quarto

Translate a Beamer `.tex` lecture to a Quarto RevealJS `.qmd` mirror.

- Repository: https://github.com/pedrohcgs/claude-code-my-workflow (1676 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-09-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add pedrohcgs/claude-code-my-workflow --skill translate-to-quarto -g -a claude-code -y`
Codex: `npx skills add pedrohcgs/claude-code-my-workflow --skill translate-to-quarto -g -a codex -y`
Cursor: `npx skills add pedrohcgs/claude-code-my-workflow --skill translate-to-quarto -g -a cursor -y`
Gemini CLI: `npx skills add pedrohcgs/claude-code-my-workflow --skill translate-to-quarto -g -a gemini-cli -y`

## Description

Translate a Beamer `.tex` lecture to a Quarto RevealJS `.qmd` mirror. Multi-phase: TikZ extraction → slide-by-slide translation → citation conversion → automatic QA parity check. Use when user says "translate to quarto", "port to revealjs", "make an html version", "convert this beamer to quarto", "mirror this lecture in qmd", or after a Beamer deck is ready for web publication. Output lands in `Quarto/`.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Beamer → Quarto Translation Workflow

Full translation of a Beamer LaTeX lecture to Quarto RevealJS HTML slides.

**The Beamer `.tex` is the source of truth:** the `.qmd` mirrors it, and corrections found during translation go back to the `.tex` (Phase 10).

---

## Phase 0: Pre-Flight Checks

### 0A. Environment Parity Audit
Scan Beamer for all custom environments. Verify CSS equivalents exist in your theme SCSS. If any are missing, create them FIRST.

### 0B. TikZ Freshness Verification
Run `/extract-tikz` to verify SVGs match current Beamer source.

### 0C. RDS Data Inventory
List all RDS files needed for interactive charts.

### 0D. Citation Key Mapping
Extract all citations from Beamer, map to bibliography keys.

## Phase 1: Pre-Translation Preparation
- Read complete Beamer source, count frames
- Inventory figures (TikZ → SVG, R plots → plotly, other → SVG)

## Phase 2: Create QMD File with YAML Header
- Standard RevealJS YAML with theme, logo, footer, bibliography
- Setup chunk for R data loading if needed

## Phase 3: Slide-by-Slide Translation
- Delegate to `beamer-translator` agent
- 1:1 frame-to-slide mapping
- Verbatim math, environment parity, no font reduction

## Phase 4: TikZ Diagram Integration
Reference extracted SVGs with 0-based indexing.

## Phase 5: R Figure Integration (Plotly-First)
Interactive plotly from RDS data, static SVG for TikZ/complex figures.

## Phase 6: First Render & Content Fidelity Check
Render, count slides, go through EVERY slide checking for issues.

## Phase 6.5: Pedagogical Review
Run pedagogy-reviewer before visual polish.

## Phase 7: Visual Polish
Semantic colors, transition slides, framing sentences.

## Phase 8: Proofreading
Run `/proofread` on the QMD file.

## Phase 9: Final Verification & Deployment
Render, then check the rendered output yourself (the rendered HTML, plus any screenshot or PDF export the user supplies), every figure present, no overflow, all environments styled.

The rest: https://github.com/pedrohcgs/claude-code-my-workflow/blob/HEAD/.claude/skills/translate-to-quarto/SKILL.md