Agent skill

Zh Cn Setup

by taekchef in taekchef/claude-code-zh-cn

完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文,或想完整启用中文化,请使用本 skill。

MITAuto-check passedFrontend & Design

Install Zh Cn Setup

skills CLI
$ npx skills add taekchef/claude-code-zh-cn --skill zh-cn-setup -a claude-code

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

GitHub CLI
$ gh skill install taekchef/claude-code-zh-cn zh-cn-setup --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/taekchef/claude-code-zh-cn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/zh-cn-setup .claude/skills/zh-cn-setup && 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
zh-cn-setup
GitHub stars
781
Token cost
~654 tokens
SKILL.md length
185 words
Files
3 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文,或想完整启用中文化,请使用本 skill。

  • Works in 5 steps: 合并 spinner 中文化配置到… → 检测 CC Switch:若检测到 CC Switch… → 报告 patch 状态并提示是否需要重启 → …
  • Tasks that involve Internationalization
  • SKILL.md covers 何时使用, 执行步骤, 重要约束 and CC Switch skill 描述同步工具, plus 1 more section
  • Runs JavaScript scripts from its folder; calls claude and node

What it does

Zh Cn Setup is an agent skill from taekchef/claude-code-zh-cn. 完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文,或想完整启用中文化,请使用本 skill。

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/cc-switch-descriptions.js` and `scripts/setup.js`).

It sits in Frontend & Design, covering Internationalization. The repository describes itself as: Claude Code CLI 简体中文本地化 / 汉化插件;支持 macOS、Linux、WSL、Windows 与新版 native,一行安装,更新后自动修复。 The licence is MIT.

When your agent uses it

  • Tasks that involve Internationalization

Example prompts

  • “/zh-cn-setup”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Bash(node:${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js:*), Bash(node:*skills/zh-cn-setup/scripts/setup.js*:*), Write, Read

Workflow steps

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

  1. 合并 spinner 中文化配置到 ~/.claude/settings.json(从插件内置的 verbs/tips 数据构建,只补齐缺失项,不覆盖用户已有配置;带备份 + 原子写)
  2. 检测 CC Switch:若检测到 CC Switch 的通用配置缺少中文设置,脚本会输出需要用户确认的提示——因为是交互式安装,请把脚本输出的指令原文转达给用户,让用户决定是否授权同步
  3. 报告 patch 状态并提示是否需要重启
  4. 输出 skill 描述汉化的只读扫描、翻译和恢复命令;CC Switch skill 位于 ~/.claude 外时,使用 ZH_CN_SKILL_I18N_EXTRA_ROOTS 指定真实目录
  5. 检测 CC Switch 数据库 skill 描述:若 ~/.cc-switch/cc-switch.db 的 skills 表中描述仍为英文、但对应 SKILL.md 已翻译为中文,脚本会提示运行可选工具…

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(node:${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js:*)
    • Bash(node:*skills/zh-cn-setup/scripts/setup.js*:*)
    • Write
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • claude
    • node

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

  • Network

    No URLs in SKILL.md.

    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

Zh Cn Setup loads about 654 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 185 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from taekchef/claude-code-zh-cn at commit 683053a, republished under its MIT licence (© taekchef). 185 words, ~654 tokens.

Download SKILL.mdSave it as .claude/skills/zh-cn-setup/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
zh-cn-setup
description
完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文,或想完整启用中文化,请使用本 skill。
allowed-tools
Bash(node:${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js:*), Bash(node:*skills/zh-cn-setup/scripts/setup.js*:*), Write, Read

zh-cn-setup:中文本地化增强安装

本 skill 是 claude-code-zh-cn 插件的首次增强安装入口。在用户通过 claude plugin marketplace add + claude plugin install 装好插件后,运行本 skill 可补齐以下"装插件本身不会自动完成"的步骤。

何时使用

当用户表达以下意图时主动触发:

  • "spinner 还是英文" / "转圈的文字没翻译"
  • "怎么完整启用中文" / "安装完后还要做什么"
  • 在 Windows / macOS / Linux 上刚装好插件,想确认中文化是否完整

执行步骤

运行跨平台安装脚本(macOS / Linux / Windows 通用,需 Node.js):

bash
node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js"

脚本会自动完成:

  1. 合并 spinner 中文化配置到 ~/.claude/settings.json(从插件内置的 verbs/tips 数据构建,只补齐缺失项,不覆盖用户已有配置;带备份 + 原子写)
  2. 检测 CC Switch:若检测到 CC Switch 的通用配置缺少中文设置,脚本会输出需要用户确认的提示——因为是交互式安装,请把脚本输出的指令原文转达给用户,让用户决定是否授权同步
  3. 报告 patch 状态并提示是否需要重启
  4. 输出 skill 描述汉化的只读扫描、翻译和恢复命令;CC Switch skill 位于 ~/.claude 外时,使用 ZH_CN_SKILL_I18N_EXTRA_ROOTS 指定真实目录
  5. 检测 CC Switch 数据库 skill 描述:若 ~/.cc-switch/cc-switch.db 的 skills 表中描述仍为英文、但对应 SKILL.md 已翻译为中文,脚本会提示运行可选工具 cc-switch-descriptions.js(默认只读预览,--apply 才写入并先备份数据库,输出还原命令)

重要约束

  • 不要在 skill 里调用 claude plugin install / claude plugin update:插件本体的安装/更新由用户手动或 Claude plugin manager 负责,避免"插件装自己/更新自己"的循环
  • CLI patch(npm cli.js / native exe)由 session-start hook 自动维护,不在本 skill 内手动 patch。native exe 更新后需要用户关闭所有 Claude Code 窗口再重开,脚本会提示
  • CC Switch 数据库写入必须由用户主动授权:cc-switch-descriptions.js 的 --apply 只在用户主动运行时执行,skill 只输出命令,不在进程内替用户写数据库
  • 脚本所有写操作都带备份和失败回滚,不会让机器配置损坏

CC Switch skill 描述同步工具

ZH_CN_SKILL_I18N_EXTRA_ROOTS 只翻译 SKILL.md 文件本体,不会写 CC Switch 数据库。若脚本检测到 ~/.cc-switch/cc-switch.db 的 skills 表描述仍为英文,把以下命令原文转达给用户:

bash
# 只读预览(默认,不写入)
node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/cc-switch-descriptions.js"
# 确认后写入(先备份数据库,输出还原命令)
node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/cc-switch-descriptions.js" --apply

同一份 description 同时用于 CC Switch 管理界面、Claude Code /skills 面板和 model 自动触发,所以默认只读、由用户决定是否 --apply。

给用户的最终提示

脚本跑完后,根据其输出告诉用户:

  • 如果提示"请重启 Claude Code":说明 CLI patch 已由 hook 处理,重启后生效
  • 如果提示 CC Switch 同步:把脚本给出的手动步骤或授权命令转给用户
  • 如果提示 Windows 需手动运行 install.ps1 -UpdateOnly:确认用户已完全退出所有 Claude Code 窗口后,把脚本输出的两行命令原文转给用户(Set-Location '<目录>' + powershell ... -File .\install.ps1 -UpdateOnly)。务必提醒扩展名必须是 .ps1(末尾的 1 不能漏),否则 PowerShell 会报 the file does not have a '.ps1' extension。

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

Files

SKILL.md and 2 other files (scripts) in plugin/skills/zh-cn-setup of taekchef/claude-code-zh-cn.

  • SKILL.md
  • scripts/cc-switch-descriptions.js
  • scripts/setup.js

Open the folder on GitHubat commit 683053a

Compare with similar skills

Zh Cn Setup 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.

Zh Cn Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zh Cn Setup this skilltaekchef/claude-code-zh-cn781—~654Automated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Chatbox i18n Translatorchatboxai/chatbox42k—~508Automated safety check: PassGPL-3.0
Internationalization Workflow with i18niOfficeAI/AionUi33k1 repos~1.9kAutomated safety check: PassApache-2.0
Enforce Rules For I18nmoeru-ai/airi50k—~1.5kAutomated safety check: PassMIT
Claude Desktop Chinese Localizationjavaht/claude-desktop-zh-cn7.5k—~1.6kAutomated safety check: PassMIT

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Chatbox i18n Translator

    chatboxai/chatbox

    Translates new or changed i18n keys from a Chatbox Pro diff, staged changes or a commit range, writing the locale JSON files directly with a built-in glossary.

    42k GitHub stars~508 tokensUpdated 14 days ago
    Frontend & DesignAuto-check passed
  • Standards for keeping all user-facing text translatable: read the i18n config first, use namespaced keys, reuse shared strings and follow the key naming rules.

    33k GitHub starsUsed in 1 repo~1.9k tokens
    Frontend & DesignAuto-check passed
  • Review pending AIRI translations on Crowdin in a batch, then sync them into the repository.

    50k GitHub stars~1.5k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Claude Desktop Chinese Localization

    javaht/claude-desktop-zh-cn

    Adds missing Simplified and Traditional Chinese translations to the Claude Desktop Chinese patch across three layers, then checks how many mappings actually hit.

    7.5k GitHub stars~1.6k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Taro UI Guide

    jd-opensource/taro-ui

    Guides installing, configuring, styling and using taro-ui (At* components) in Taro apps for WeChat, Alipay, H5 and React Native.

    4.7k GitHub stars~1.3k tokensUpdated 13 days ago
    Frontend & DesignAuto-check passed

Questions about Zh Cn Setup

What does Zh Cn Setup do?

完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文,或想完整启用中文化,请使用本 skill。. Zh Cn Setup is an agent skill from taekchef/claude-code-zh-cn.

When should I use Zh Cn Setup?

Zh Cn Setup fits situations like: tasks that involve Internationalization.

How do I install Zh Cn Setup in Claude Code?

Run `npx skills add taekchef/claude-code-zh-cn --skill zh-cn-setup -a claude-code`. Or copy the skill folder (plugin/skills/zh-cn-setup in taekchef/claude-code-zh-cn) into .claude/skills/zh-cn-setup in your project. Claude Code loads it when a task matches its description.

How do I install Zh Cn Setup in Codex?

Run `npx skills add taekchef/claude-code-zh-cn --skill zh-cn-setup -a codex`. Or copy the skill folder (plugin/skills/zh-cn-setup in taekchef/claude-code-zh-cn) into .agents/skills/zh-cn-setup in your project. Codex loads it when a task matches its description.

Can I use Zh Cn Setup 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 taekchef/claude-code-zh-cn --skill zh-cn-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zh-cn-setup, .gemini/skills/zh-cn-setup, .github/skills/zh-cn-setup and .opencode/skills/zh-cn-setup in your project.

What does Zh Cn Setup need to run?

Going by SKILL.md and its folder, Zh Cn Setup needs JavaScript for the scripts in its folder and the command-line tools its instructions call (claude and node). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash(node:${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js:*), Bash(node:*skills/zh-cn-setup/scripts/setup.js*:*), Write, Read.

Does Zh Cn Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Zh Cn Setup 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Zh Cn Setup use?

Zh Cn Setup 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 Zh Cn Setup use?

About 654 tokens (SKILL.md is roughly 2.6k 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 Zh Cn Setup?

Skills that share tags, products or a category with Zh Cn Setup: Impeccable (bestofjs/bestofjs, 3.1k stars), Chatbox i18n Translator (chatboxai/chatbox, 42k stars), Internationalization Workflow with i18n (iOfficeAI/AionUi, 33k stars) and Enforce Rules For I18n (moeru-ai/airi, 50k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zh Cn Setup?

taekchef (a GitHub user) maintains it in taekchef/claude-code-zh-cn, which has 781 GitHub stars. The repository was last updated on October 8, 2026.

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