# Translate Docs

Use when explicitly asked to translate, backfill, reconcile, rename, or delete paired...

- Repository: https://github.com/CherryHQ/cherry-studio (53164 stars)
- Category: Writing
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add CherryHQ/cherry-studio --skill translate-docs -g -a claude-code -y`
Codex: `npx skills add CherryHQ/cherry-studio --skill translate-docs -g -a codex -y`
Cursor: `npx skills add CherryHQ/cherry-studio --skill translate-docs -g -a cursor -y`
Gemini CLI: `npx skills add CherryHQ/cherry-studio --skill translate-docs -g -a gemini-cli -y`

## Description

Use when explicitly asked to translate, backfill, reconcile, rename, or delete paired Cherry Studio repository documentation in English and Simplified Chinese, including Phase 3 domain-by-domain translation work.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Translate Repository Documentation

Read [the pairing contract](../../../docs/i18n/README.md), [translation rules](../../../docs/i18n/translation-rules.md), generated [terminology](../../../docs/i18n/terminology.md), and `docs-governance` before translating.

## Triage

- Existing pair, one side changed: use the sidecar hashes to identify the authored side and patch the smallest affected counterpart unit.
- Both sides changed or the recorded blob is unavailable: reconcile the complete affected section manually.
- New pair: translate section by section while preserving structure.
- Rename/delete: move/delete English, Chinese, and sidecar together.

Do not silently repair inaccurate technical content during translation. Report the source defect or fix both languages against current code when the task authorizes it.

## Batch work

When the user requests a domain or corpus backfill, divide files into disjoint domain-owned sets. Translation workers read the complete rules and terminology, modify only assigned pairs, and return pending terms. The integrating agent resolves terminology in `scripts/i18n-glossary.json`, regenerates the terminology page and indexes, checks links/structure, records sidecars, and runs the corpus gate.

## Finish

Verify clauses, identifiers, code fences, lists, tables, links, frontmatter, and natural phrasing. Then run:

```sh
pnpm docs:check-pairing --write <pair>
pnpm docs:check-pairing <pair>
```

Run `pnpm docs:check` once at PR level. A green pairing gate does not prove semantic fidelity.