Borrowing it
Nothing to install: this file belongs to xiaolai/vmark. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/xiaolai/vmark/main/.claude/skills/translate-docs/SKILL.mdgit clone --depth 1 https://github.com/xiaolai/vmarkWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/xiaolai/vmark/translate-docs)<a href="https://agentmods.dev/skills/xiaolai/vmark/translate-docs"><img src="https://agentmods.dev/badge/skills/xiaolai/vmark/translate-docs/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/xiaolai/vmark/translate-docs"><img src="https://agentmods.dev/badge/skills/xiaolai/vmark/translate-docs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00067 | $0.03876 |
| Opus 5.5 | $0.00027 | $0.01550 |
| Sonnet 5.5 | $0.00013 | $0.00775 |
| Haiku 4.5 | $0.00007 | $0.00388 |
Grade A, and why
translate-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 345 lines — stays where its author put it; the contents beside it link to each section on GitHub.
VMark Translation
Two modes share the same 9 locales, the same subagent pipeline, and the same cultural rules:
- Docs mode (default) — translate
website/guide/**/*.mdmarkdown files. - App string mode (
--app) — sync new keys acrosssrc/locales/{locale}/*.json(i18next) andsrc-tauri/locales/{locale}.yml(rust-i18n).
Docs mode is the original flow; App string mode was added to handle the smaller, structured strings that the app ships every day. They share Stages 2–4 (translate → audit → cultural polish) but differ in what they read, what they write, and how they protect existing content.
When to Use
Docs mode
- Adding a new page to
website/guide/ - Updating an existing page that needs translation sync
- User asks to "translate", "localize", or "add language support" for website content
App string mode (--app)
- New keys appear in
src/locales/en/*.jsonorsrc-tauri/locales/en.ymlwithout matching entries in other locales pnpm lint:i18nreports missing keys- User asks to "sync locale files", "translate new i18n keys", or "propagate locale keys"
Target Locales
| Code | Language | CJK? |
|---|---|---|
zh-CN |
Simplified Chinese | Yes |
zh-TW |
Traditional Chinese | Yes |
ja |
Japanese | Yes |
ko |
Korean | Yes |
de |
German | No |
fr |
French | No |
es |
Spanish | No |
it |
Italian | No |
pt-BR |
Brazilian Portuguese | No |
Workflow
Step 1: Prepare Source
- Read the English source file from
website/guide/... - Identify the file path pattern (e.g.,
guide/users-as-developers/foo.md) - Check that all target locale directories exist:
website/{locale}/guide/...
Step 2: Translate (parallel subagents)
Dispatch up to 9 translation subagents in parallel — one per locale. Each subagent receives:
- The full English source content
- The target locale code and language name
- Translation rules (see below)
Translation Rules for Every Locale:
- Translate all prose — headings, paragraphs, list items, block quotes, alert blocks
- Preserve markdown structure exactly — headings levels, link URLs, code blocks, tables, images, front matter
- Keep technical terms in English — product names (VMark, Tauri, ProseMirror, Tiptap, CodeMirror, Mermaid, Vitest), programming terms in code context (LOC, TDD, CI/CD, API, MCP), file paths, command names
- Translate table headers and cell text — but keep code/numbers as-is
- Translate VitePress containers —
::: info,::: tip,::: warninglabels stay as-is (VitePress renders them), but translate the content inside - Adapt culturally — don't just word-swap. Use natural phrasing. Examples:
- "TL;DR" → "太长不看版" (zh-CN), "要約" (ja), "요약" (ko)
- "out of the box" → use the local idiom, not a literal translation
- Currency/number formatting: use locale conventions in prose (but keep raw numbers in tables/code)
- Em-dash spacing — follow VMark convention:
word — wordwith spaces in English/European locales. CJK locales use——(double em-dash) without spaces.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 345 lines · 67 tokens per session scan A 7683af50abbe
translate-docs is a skill published in the GitHub repository xiaolai/vmark (878 stars, last pushed yesterday), licensed ISC. It adds 67 tokens to every session and 3,876 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
intl-expansion
International market expansion strategy. Market selection, entry modes, localization, regulatory compliance, and go-to-market by region. Use when expanding to new countries, evaluating international markets, planning localization, or building regional teams.
chinese-documentation
A Chinese technical-documentation style guide covering spacing, punctuation, numbers, terminology, and links when Chinese and English appear together.
azure-ai-translation-text-py
Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications. Triggers: "text translation", "translator", "translate text", "transliterate", "TextTranslationClient".
harden
Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. Use when the user asks to harden, make production-ready, handle edge cases, add error states, or fix overflow and i18n issues.
edit-site
Plans, coordinates and customizes PAC CLI-downloaded Standard or Enhanced data model non-SPA Power Pages sites created from Microsoft templates or manually in Design Studio. Use for requests involving pages, localized content, navigation, assets, snippets, site markers, Liquid/web templates, page layouts, or styling.…
asc-subscription-localization
Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.