# Translate

> Multi-format document translation. Supports Typst ↔ Quarto. For Beamer translations, configure at project level.

- Skill: `clearsmog/translate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clearsmog/translate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clearsmog/translate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: clearsmog (https://skillmd.com/u/clearsmog)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/clearsmog/translate

---


# 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.