translate

Translates documents and i18n resource files through a plan-approve-translate-verify pipeline.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill translate-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translate
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-research-pipe/skills/translate
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill translate-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Translating documentation and localization files by hand or with ad-hoc LLM prompts risks corrupted placeholders, broken Markdown structure, inconsistent terminology, and overwritten originals. This Skill orchestrates a controlled translation pipeline with an approval gate, parallel translator agents, and three tiers of verification so file translations stay structurally intact and terminologically consistent. ## Core Features & Use Cases - Plan-Approve-Translate Flow: Discovery produces a reviewable plan (files, languages, output mode, glossary, wave plan) that requires explicit user approval before any translator dispatches. - Three-Tier Verification: Tier-1 structural parity checks (fence counts, headings, placeholders), Tier-2 LLM-as-Judge semantic review on every chunk, and Tier-3 uncertainty-driven lookups via Wiktionary, MyMemory, and back-translation. - Broad Format Support: Handles md, mdx, json, yaml, po, properties, strings, xliff, and txt files with sidecar, inplace, or i18n output modes and automatic source-language detection. - Use Case: Run "translate README.md to Russian" to get a chunked, glossary-seeded translation written to README.ru.md, with every placeholder like {{user.name}} preserved byte-identical and a summary of verification verdicts. ## Quick Start Ask the assistant to translate README.md to Japanese using the translate skill and approve the generated plan when prompted.

Frequently Asked Questions about translate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate a README or docs folder to another language?

Invoke the translate skill with a request like "translate README.md to ru" or "translate docs/**/*.md to Japanese". It discovers matching files, builds a plan with a seeded glossary, and after your approval dispatches parallel translator agents that write sidecar output files.

What file formats does the translate skill support?

Supported formats are md, mdx, json, yaml, yml, po, properties, strings, xliff, and txt. Binary formats like docx, pdf, and images are unsupported and trigger an escalation asking how to proceed.

How are i18n placeholders like {{name}} or %1$s handled during translation?

Placeholders are enumerated with PCRE2 regexes, substituted with opaque [[Pn]] tokens before translation, then restored afterward. ICU plural and select blocks are decomposed structurally so branch bodies translate per target-language plural rules.

Can I translate files in place instead of creating sidecar copies?

Yes, pass mode:inplace explicitly in the request, for example "translate CHANGELOG.md to de mode:inplace". The plan flags this as INPLACE_DESTRUCTIVE at the approval gate since the source file gets overwritten.

When should I not use the translate pipeline?

Skip it for single-sentence phrase lookups, which should be answered inline, and for code comment or string-literal polish, which belongs to the polish skill. It is a file-oriented pipeline, not a live chat translator.

How does source language detection work when I do not specify it?

Detection falls through four tiers: LibreTranslate /detect, a Unicode script heuristic, a one-shot haiku agent, and finally a user prompt. Samples under 20 characters skip all tiers and require explicit specification.