| name | doc-i18n |
| description | Bilingual documentation translation and synchronization for path-based i18n projects. This skill should be used when users need to translate, compare, or synchronize documentation between Chinese and English versions. Triggers include requests to translate docs, sync i18n, compare zh/en docs, translate this page, check translation coverage, or any task involving bilingual Markdown documentation alignment. Supports both zh-to-en and en-to-zh translation directions. |
doc-i18n: Bilingual Documentation Translation Skill
Purpose
Translate, compare, and synchronize bilingual (Chinese / English) Markdown documentation in path-based i18n projects. Ensure structural alignment, content consistency, and adherence to project-specific conventions.
When to Use
- Translating a documentation file from one language to another
- Comparing two language versions for content drift or missing sections
- Checking translation coverage across the documentation tree
- Fixing heading IDs, internal links, or container syntax after translation
- Creating a new translation file from an existing source
Workflow
Phase 1: Analyze
Before making any changes, analyze the task:
-
Identify the source and target files. Determine the translation direction:
- English to Chinese:
docs/pages/{path}.md to docs/pages/zh/{path}.md
- Chinese to English:
docs/pages/zh/{path}.md to docs/pages/{path}.md
-
Read both files (source and target). If the target file does not exist, note that a new file must be created.
-
Generate a diff report listing:
- Headings present in source but missing/untranslated in target
- Paragraphs or sections with untranslated content (e.g., Chinese text in the English file)
