mcpbeat

Translate To Quarto

pedrohcgs/translate-to-quarto

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/`.

623 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1440
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill translate-to-quarto

The instruction itself

18 sections, as written by the author

Beamer → Quarto Translation Workflow

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

CRITICAL: The Beamer .tex file is the SINGLE SOURCE OF TRUTH.


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, open in browser, verify all elements.

Phase 10: Beamer Source Sync

Apply any corrections back to Beamer source.

Phase 11: Documentation

Update CLAUDE.md, session log, create PR.

How to use it

Copy the folder

Take pedrohcgs/translate-to-quarto from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.