# Sync Translation

> Sync a Chinese translation file with its English source by comparing sections and applying missing or outdated differences

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

---


# Sync Translation

Compare an English source file with its Chinese translation and apply missing or changed sections.

## Goal

Make the translation file content-identical to the English source (in translated form). All sections in the source must be present and translated; no stale content remains.

## Steps

### 1. Detect file pair

Auto-detect the source/translation pair by looking for common patterns:
- `README.md` / `README.zh-CN.md`
- `CHANGELOG.md` / `CHANGELOG.zh-CN.md`
- Any `*.md` / `*.zh-CN.md` pair in the project root

If multiple pairs exist, ask the user which to sync.

**Success criteria**: Both file paths identified and confirmed.

### 2. Read both files

Read the full content of both the source and translation files.

**Success criteria**: Both files fully loaded and comparable.

### 3. Diff sections

Systematically compare sections between the two files:
- Find missing sections in the translation
- Find changed/moved content (e.g. items moved between categories)
- Find removed content that is stale in the translation

**Success criteria**: Complete list of differences identified.

### 4. Apply edits

Edit the translation file to match the source. Translate new content to match the existing style and tone of the translation file. Use the Edit tool for each change.

**Rules**:
- Preserve existing translations that are still accurate
- Match the writing style and tone of the existing translation
- Minimize the number of edits by combining adjacent changes

**Success criteria**: All identified differences resolved in the translation file.

### 5. Report changes

Summarize what was synced in a concise bulleted list.

**Success criteria**: User has a clear summary of all changes made.