Agent skill

Translate Docs

by MoonshotAI in MoonshotAI/kimi-code

Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

MITAuto-check passedWriting & Content

Install Translate Docs

skills CLI
$ npx skills add MoonshotAI/kimi-code --skill translate-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MoonshotAI/kimi-code translate-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/translate-docs .claude/skills/translate-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
translate-docs
GitHub stars
7.8k
Token cost
~976 tokens
SKILL.md length
510 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

  • Works in 4 steps: Detect what needs syncing → Translate page by page, section by section → Apply terminology and typography rules… → …
  • Tasks that involve Translation
  • SKILL.md covers Overview, Prerequisites, Locale sync rules and Workflow, plus 2 more sections
  • Calls git and pnpm

What it does

Translate Docs is an agent skill from MoonshotAI/kimi-code. Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Translation and Agent instruction files. The repository describes itself as: Kimi Code CLI — The Starting Point for Next-Gen Agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Translation
  • Tasks that involve Agent instruction files

Example prompts

  • “/translate-docs”

Requirements

  • A credential in YOUR_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Detect what needs syncing
  2. Translate page by page, section by section
  3. Apply terminology and typography rules from docs/AGENTS.md
  4. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 0f052fe. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Translate Docs loads about 976 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 510 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~976

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MoonshotAI/kimi-code at commit 0f052fe, republished under its MIT licence (© MoonshotAI). 510 words, ~976 tokens.

Download SKILL.mdSave it as .claude/skills/translate-docs/SKILL.md (or your agent's skills folder).
name
translate-docs
description
Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

Translate Docs

Overview

This repository keeps bilingual user documentation under docs/zh/ and docs/en/. This skill synchronizes the two locales, page by page, after either side has been updated.

This skill is invoked by both gen-docs (incremental updates) and audit-docs (full pre-release audit) to keep locale mirrors in sync.

Prerequisites

If any of the following are missing, stop and report to the user before continuing:

  • docs/zh/ and docs/en/ mirrored directory structure.
  • docs/AGENTS.md — terminology table, typography rules, and source-of-truth rules.

Locale sync rules

  • Changelog (release-notes/changelog.md): English is the source. Translate to Chinese.
  • Breaking changes (release-notes/breaking-changes.md): English is the source. Translate to Chinese.
  • All other pages: docs/en/ and docs/zh/ are mirrored pairs. After either side changes, update the other locale in the same change.

When non-changelog pages change in either locale, sync the mirror before release. When the English changelog changes, sync the Chinese changelog.

Workflow

  1. Detect what needs syncing

    • git diff main..HEAD --stat docs/ — see which files changed
    • For each changed file under docs/en/ or docs/zh/, locate its mirror in the other locale (same relative path).
  2. Translate page by page, section by section

    • Keep heading hierarchy, list structure, code blocks, callout blocks, and link targets identical between the two versions.
    • When in doubt about a technical term, read the actual code to confirm behavior rather than guessing.
  3. Apply terminology and typography rules from docs/AGENTS.md

    • Use the term table exactly. Do not invent translations or use synonyms.
    • English H2+ uses sentence case (proper nouns excepted, per the term table).
    • Chinese typography: full-width punctuation (,。;:?!()), space between Chinese and ASCII (letters / numbers / inline code / links).
    • Callout titles (::: tip / ::: warning / ::: info / ::: danger) use the short Chinese labels from docs/AGENTS.md.
  4. Verify

    • git diff docs/ — scan for terminology drift or punctuation regressions.
    • Run the docs build if available (pnpm --filter docs run build or equivalent) to catch broken links and Markdown errors.
Show full SKILL.md (202 more words)Show less

Rules and conventions

  • Do not one-sided fixes: if the changed locale has an unclear or incorrect statement, fix it there first; do not patch only the mirror.
  • Match style, not just words: Chinese docs use a narrative tone (see docs/AGENTS.md writing-style examples); preserve that tone in Chinese; preserve sentence-case headings and concise English style in English.
  • Code blocks and identifiers stay as-is: do not translate code, command names, flag names, or file paths.
  • Public examples: Do not introduce real internal endpoints, key names, account names, or service names while translating. Keep or replace them with neutral placeholders such as example.com, example.test, and YOUR_API_KEY in both locales.

Common mistakes

  • Rewriting only the mirror because a phrase feels awkward in the target language — fix the changed locale first, then sync.
  • Letting English headings slip into Title Case (only sentence case is allowed for H2+).
  • Forgetting to add spaces between Chinese characters and inline code or English words.
  • Translating proper nouns listed in the term table (Wire, MCP, ACP, JSON, OAuth, macOS, uv, etc.).
  • Updating only one direction and leaving the other locale stale — always finish all pages flagged by the diff.
  • Copying real internal values into the mirror instead of using neutral example placeholders.

© MoonshotAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/translate-docs of MoonshotAI/kimi-code.

Open the folder on GitHubat commit 0f052fe

Compare with similar skills

Translate Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Translate Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Translate Docs this skillMoonshotAI/kimi-code7.8k—~976Automated safety check: PassMIT
Dsh Web Documentationzhu1090093659/dsh-web8.5k—~479Automated safety check: PassApache-2.0
Translate Skillvinvcn/mattpocock-skills-zh-CN4.7k—~1.1kAutomated safety check: PassMIT
Write Evlog Contentevloghq/evlog1.9k—~386Automated safety check: PassMIT
Review Steeringdralgorhythm/claude-agentic-framework125—~1.1kAutomated safety check: PassNone
China Travel Kittczyliu/china-travel-kit194—~1.3kAutomated safety check: PassMIT

Similar skills

  • Dsh Web Documentation

    zhu1090093659/dsh-web

    A skill your agent uses when adding or editing dsh-web README files, docs, AGENTS.md instructions, user-facing configuration text, or bilingual documentation pairs.

    8.5k GitHub stars~479 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Translate Skill

    vinvcn/mattpocock-skills-zh-CN

    将 mattpocock/skills 的内容翻译、刷新或复核到简体中文本地化仓库 vinvcn/mattpocock-skills-zh-CN 时使用这个项目级 skill。适用于 skill files、README content、CLAUDE.md、CONTEXT.md、docs,以及其他需要保留行为关键 identifiers 的上游用户可见内容。

    4.7k GitHub stars~1.1k tokensUpdated 10 days ago
    Agent WorkflowsAuto-check passed
  • Write Evlog Content

    evloghq/evlog

    The evlog content doctrine, for anyone drafting or judging evlog prose: a docs page, the landing, a blog post, a package README, a skill, an AGENTS.md, a changeset.

    1.9k GitHub stars~386 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Review Steering

    dralgorhythm/claude-agentic-framework

    Compiles REVIEW.md and keeps CLAUDE.md accurate as the two sanctioned surfaces for steering Anthropic's managed Code Review service, translating this repo's rules into terse reviewer imperatives.

    125 GitHub stars~1.1k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • China Travel Kit

    tczyliu/china-travel-kit

    Research and plan first-time independent trips in China with bilingual, source-aware city data and official live-check entry points.

    194 GitHub stars~1.3k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Create Release Blog

    web-infra-dev/rstest

    Generate a narrative version release blog post from commits within a tag range.

    505 GitHub stars~4.7k tokensUpdated today
    Writing & ContentAuto-check passed

More from MoonshotAI/kimi-code

All 11 skills in this repo
  • Kimi Webbridge

    MoonshotAI/kimi-code

    Kimi Browser Extension(Kimi 浏览器扩展,原 Kimi WebBridge)lets AI control the user's real browser — navigate, click, type, read, screenshot, and interact with any website using the user's actual login…

    7.8k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Gen Changesets

    MoonshotAI/kimi-code

    A skill your agent uses when generating changesets in the kimi-code repository — deciding whether to write one, which package to list, the bump level, the wording, and the confirmation workflow.

    7.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Gen Docs

    MoonshotAI/kimi-code

    Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

    7.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Kimi Datasource

    MoonshotAI/kimi-code

    Universal data-source assistant for stocks (Wind, S&P, SEC EDGAR), macro (World Bank, IMF, FRED, NBS), Chinese government data and standards (GB/HB/DB/TT), corporate, academic, legal, WHO/FAO/OECD…

    7.8k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Pre Changelog

    MoonshotAI/kimi-code

    Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese.

    7.8k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Review PR

    MoonshotAI/kimi-code

    在 kimi-code 仓库里 review 一个 PR 时使用:按 PR 模板逐节核对描述与 diff,并单独做一轮"回归与用户影响"评审,给出影响等级与评审摘要,评审摘要用用户当前使用的语言。

    7.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Translate Docs

What does Translate Docs do?

Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md. Translate Docs is an agent skill from MoonshotAI/kimi-code.md.

When should I use Translate Docs?

Translate Docs fits situations like: tasks that involve Translation; tasks that involve Agent instruction files.

How do I install Translate Docs in Claude Code?

Run `npx skills add MoonshotAI/kimi-code --skill translate-docs -a claude-code`. Or copy the skill folder (.agents/skills/translate-docs in MoonshotAI/kimi-code) into .claude/skills/translate-docs in your project. Claude Code loads it when a task matches its description.

How do I install Translate Docs in Codex?

Run `npx skills add MoonshotAI/kimi-code --skill translate-docs -a codex`. Or copy the skill folder (.agents/skills/translate-docs in MoonshotAI/kimi-code) into .agents/skills/translate-docs in your project. Codex loads it when a task matches its description.

Can I use Translate Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MoonshotAI/kimi-code --skill translate-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/translate-docs, .gemini/skills/translate-docs, .github/skills/translate-docs and .opencode/skills/translate-docs in your project.

What does Translate Docs need to run?

Going by SKILL.md and its folder, Translate Docs needs the command-line tools its instructions call (git and pnpm). Our summary lists: A credential in YOUR_API_KEY.

Does Translate Docs access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Translate Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Translate Docs use?

Translate Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Translate Docs use?

About 976 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Translate Docs?

Skills that share tags, products or a category with Translate Docs: Dsh Web Documentation (zhu1090093659/dsh-web, 8.5k stars), Translate Skill (vinvcn/mattpocock-skills-zh-CN, 4.7k stars), Write Evlog Content (evloghq/evlog, 1.9k stars) and Review Steering (dralgorhythm/claude-agentic-framework, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Translate Docs?

MoonshotAI (a GitHub organization) maintains it in MoonshotAI/kimi-code, which has 7,796 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: MoonshotAI/kimi-code on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.