translate

name	translate
description	Multi-format document translation. Supports Typst ↔ Quarto. For Beamer translations, configure at project level.
argument-hint	[source_file] [target_format]
allowed-tools	["Read","Grep","Glob","Write","Edit","Bash","Task"]
context	fork

Multi-Format Translation Workflow

Translate documents between supported formats.

CRITICAL: The source file is the SINGLE SOURCE OF TRUTH.

---

Supported Translations

From	To	Method
.typ (Typst)	.qmd (Quarto)	Component mapping
.qmd (Quarto)	.typ (Typst)	CSS classes to components

Note: For Beamer (.tex) translations, configure at project level. Projects with Beamer support should have their own translate skill with environment mapping tables.

Format Detection

Parse $ARGUMENTS:

• First argument: source file path
• Second argument (optional): target format (.qmd, .typ)
• If no target specified, infer from project context

---

Typst → Quarto

Component Mapping

Typst (qk)	Quarto CSS
#keypoint[...]	::: {.keybox}\n...\n:::
#insight[...]	::: {.highlightbox}\n...\n:::
#tip[...]	::: {.methodbox}\n...\n:::
#note[...]	::: {.softbox}\n...\n:::
#warning[...]	::: {.keybox}\n**Warning:** ...\n:::
#trap[...]	::: {.keybox}\n**Common mistake:** ...\n:::

Citation Mapping

• @key → @key (same in Quarto)

Math Mapping

• $...$ (Typst inline) → $...$ (Quarto inline)
• $ ... $ (Typst display) → $$...$$ (Quarto display)

---

Quarto → Typst

Component Mapping

Quarto CSS	Typst (qk)
::: {.keybox}	#keypoint[...]
::: {.highlightbox}	#insight[...]
::: {.methodbox}	#tip[...]
::: {.resultbox}	#keypoint[...]
::: {.quotebox}	#quote(attribution: "...")[...]
::: {.softbox}	#note[...]

Math Mapping

• $...$ → $...$
• $$...$$ → $ ... $ (display)

---

Quality Standards (All Translations)

1. Content parity — every idea from source must appear in target
2. Environment parity — every box/callout must use the corresponding target element
3. Notation consistency — same symbols as source
4. No content loss — never summarize or condense
5. All citations verified — every reference resolves
6. All images referenced — every figure path valid
7. Compile successfully — target must build without errors

Post-Translation

Run /qa on the translated file to verify quality.