# Translate
> Translate a rendered Q&A card HTML in podcast/notes/ into a target language. Takes a language code argument (e.g. zh, ja, es) and writes to podcast/notes-/. Preserves template structure and only swaps text content.
- **Type:** Skill
- **Install:** `agentstack add skill-0-bingwu-0-html-knowledge-base-templates-translate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [0-bingwu-0](https://agentstack.voostack.com/s/0-bingwu-0)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [0-bingwu-0](https://github.com/0-bingwu-0)
- **Source:** https://github.com/0-bingwu-0/html-knowledge-base-templates/tree/main/podcast-question-cards/skills/translate
## Install
```sh
agentstack add skill-0-bingwu-0-html-knowledge-base-templates-translate
```
Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.
## About
You translate a rendered Q&A card HTML page into a target language.
Goal:
Produce a localized version of an English Q&A card page without touching layout, styles, or markup — only the text content is translated.
---
USAGE
```
/translate
```
Example:
```
/translate zh podcast/notes/lenny-2026-05-03.html
/translate ja podcast/notes/lenny-2026-05-03.html
```
Where `` is an ISO 639-1 code (`zh`, `ja`, `es`, `fr`, `de`, ...). For Chinese, default to Simplified (`zh` → zh-CN) unless `zh-TW` is given explicitly.
---
INPUT
A rendered Q&A card HTML file produced by [[digest]], typically at:
podcast/notes/{channel_slug}-{published_date}.html
---
OUTPUT FILE
Write the translated HTML to:
podcast/notes-{lang}/{channel_slug}-{published_date}-{lang}.html
Example:
- input → `podcast/notes/lenny-2026-05-03.html`
- `/translate zh` → `podcast/notes-zh/lenny-2026-05-03-zh.html`
- `/translate ja` → `podcast/notes-ja/lenny-2026-05-03-ja.html`
Create the `podcast/notes-{lang}/` directory if it does not exist.
Do NOT paste HTML into chat.
The chat response should only say:
Created podcast/notes-{lang}/{filename}
---
WHAT TO TRANSLATE
Translate the human-readable text content:
- `` and the episode title heading
- `episode-meta` items: source, guest, published date, etc.
- The `url_display` link text (keep the `href` URL itself unchanged)
- Each card's question (`.qa-question`)
- Each card's one-sentence answer (`.qa-answer`)
- Each card's source passage inside ``, including speaker labels
---
WHAT NOT TO TOUCH
- HTML tags, attributes, class names, ids, inline styles
- The template skeleton, CSS, and any `` / `` blocks
- `href` URL values (translate only the visible link text)
- Card numbering — it is CSS-generated, do not write numbers into the HTML
- The `.qa-toggle` element — it stays empty; do not add labels like "原文片段" or "Read transcript"
- Proper nouns and technical terms: **never translate or transliterate** people names, company names, product names, or technical vocabulary. Keep them verbatim in the source language — no parenthetical glosses, no romanizations, no native-form substitutions, even when an established translation exists.
- Verified spellings from the English version — do not re-romanize or re-translate names
---
LANGUAGE & STYLE
- Use natural, idiomatic phrasing in the target language. Do not translate word-for-word.
- Keep all technical vocabulary verbatim in the source language (e.g. `agency`, `product-market fit`, `RAG`). Do not translate or gloss it, even on first mention.
- Preserve the speaker's voice in `` source passages — keep them conversational, not formal prose. Do not "clean up" colloquialisms.
- Preserve paragraph breaks and speaker labels inside `` (e.g. `Host:`, `Max:`) — translate the label words but keep the structure.
---
PUBLISHED DATE
Re-render `{{published_date}}` in a form consistent with the target language:
- `zh` → `2026 年 5 月 3 日`
- `ja` → `2026年5月3日`
- `es` → `3 de mayo de 2026`
- `fr` → `3 mai 2026`
- `de` → `3. Mai 2026`
- default to the locale's conventional long date form
---
HTML HEADER
Update the document language attribute:
- `` → `` (use the full tag where appropriate: `zh-CN`, `zh-TW`, `pt-BR`)
Keep the `` and viewport meta as-is.
---
QUALITY CHECKS
- Every visible English string is translated; no stray English text remains except intentionally-kept proper nouns and technical terms.
- The translated answer still matches the question (no semantic drift).
- The source passage still supports the answer — if a translation changes the meaning, re-translate, do not rewrite the answer.
- If the source HTML has an actual error in the English text, translate faithfully first, then append a single translator note at the very end of the page in a `…` outside the card list.
## Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- **Author:** [0-bingwu-0](https://github.com/0-bingwu-0)
- **Source:** [0-bingwu-0/html-knowledge-base-templates](https://github.com/0-bingwu-0/html-knowledge-base-templates)
- **License:** MIT
Install and usage instructions live in the source repository linked above.
## Pricing
- **Free** — Free
## Security capabilities
Automated source analysis of v0.1.0 — what this tool can access:
- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no
*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*
## Versions
- **0.1.0** — security scan: passed — Imported from the upstream source.
## Links
- Listing page: https://agentstack.voostack.com/l/skill-0-bingwu-0-html-knowledge-base-templates-translate
- Seller: https://agentstack.voostack.com/s/0-bingwu-0
- Browse the marketplace: https://agentstack.voostack.com/browse
---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.