chinese-documentation-translator

Translates English technical documentation repositories into Chinese with state tracking and incremental updates.

2|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/NAMEWTA/learning-open-code --skill chinese-documentation-translator-namewta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chinese-documentation-translator
Source: https://github.com/NAMEWTA/learning-open-code/tree/main/.agents/skills/chinese-documentation-translator
Command: npx skills add https://github.com/NAMEWTA/learning-open-code --skill chinese-documentation-translator-namewta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Translating an entire English technical documentation repository (SKILL.md files, READMEs, plugin manifests, command definitions, Python scripts) into Chinese is error-prone: files get missed, source files get accidentally overwritten, and re-translating everything after a small upstream update wastes effort. This Skill provides a systematic 7-phase SOP with state tracking so translations are complete, consistent, and incremental. ## Core Features & Use Cases - Phased translation SOP: Auto-detects project type (plugin-marketplace, skill-collection, single-skill, generic-docs) and applies the right translation stages for Markdown, JSON manifests, and Python/Shell script comments. - State tracking and incremental translation: Maintains a translation-state.json with per-file SHA-256 hashes and git commit snapshots, so when the source repo updates only changed files are re-translated. - Chinese typography rules and terminology glossary: Enforces Chinese punctuation, CJK-Latin spacing, a fixed terminology table, and strict protection of frontmatter names, code blocks, and command references. - Use Case: You mirror an open-source agent-skills repository as a git submodule and want a full Chinese version. The Skill translates all 60+ files into a mirrored translator/ directory, records hashes, and later re-translates only the 3 files that changed upstream. ## Quick Start Translate the open-ai-skills/matt-pocock-skills project into Chinese, writing output to the translator/ directory and creating the translation state file.

Frequently Asked Questions about chinese-documentation-translator

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

FAQPage Schema
How do I translate an entire English documentation repository to Chinese?▼

Follow the 7-phase SOP: initialize state tracking, translate base docs, then SKILL.md files, auxiliary Markdown, command files, root README, and script comments. Output goes to a mirrored translator/ directory, never the source directory.

How to translate only updated files instead of the whole repository?▼

Use the incremental translation workflow. The Skill compares current source file SHA-256 hashes against translation-state.json, marks changed files as needs-update, and re-translates only those plus newly added files.

Does it translate YAML frontmatter and code blocks in Markdown?▼

No. Frontmatter keys and the name value stay untouched, only the description value is translated. Code blocks, inline code, command references, URLs, and $ARGUMENTS placeholders remain in English to preserve functionality.

What file types does the translation workflow support?▼

It handles SKILL.md, README.md, command .md files, plugin.json and marketplace.json manifests, Python script docstrings and comments, Shell script comments, and generic Markdown. Project type is auto-detected to select the right phases.

Why must translated files never be written back to the source directory?▼

Source directories are read-only git submodule inputs. Writing translations there corrupts the submodule and requires git checkout recovery. All output must go to the translator/ directory mirroring the source structure.