Doc Smith Localize

Translate Doc-Smith generated documentation into multiple languages. Use this skill when the user requests document translation, localization, or multi-language support. Supports batch translation of documents and images.

9 starsWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add AIGNE-io/doc-smith-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add AIGNE-io/doc-smith-skills --skill doc-smith-localize
Manual install
git clone --depth 1 https://github.com/AIGNE-io/doc-smith-skills.git /tmp/doc-smith-skills
mkdir -p ~/.claude/skills
cp -r /tmp/doc-smith-skills/skills/doc-smith-localize ~/.claude/skills/doc-smith-localize

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Doc-Smith 文档翻译

将文档翻译成多种语言,支持批量翻译和术语一致性。

## 用法

```bash
/doc-smith-localize --lang en                    # 翻译所有文档到英文
/doc-smith-localize -l en -l ja                  # 翻译到多个语言
/doc-smith-localize -l en -p /overview           # 只翻译指定文档
/doc-smith-localize -l en --force                # 强制重新翻译
/doc-smith-localize -l en --skip-images          # 跳过图片翻译
```

## 选项

| 选项 | 别名 | 说明 |
|------|------|------|
| `--lang <code>` | `-l` | 目标语言代码(可多次使用) |
| `--path <docPath>` | `-p` | 指定文档路径(可多次使用) |
| `--force` | `-f` | 强制重新翻译,覆盖已有 |
| `--skip-images` | | 跳过图片翻译 |

## 约束

以下约束在任何操作中都必须满足。

### 1. Workspace 约束

- `.aigne/doc-smith/config.yaml` 和 `planning/document-structure.yaml` 必须存在
- 不存在时提示用户先使用 `/doc-smith` 生成文档

### 2. 参数验证约束

- 目标语言不能与源语言(config.yaml 的 locale)相同
- `--path` 指定的路径必须存在于 document-structure.yaml
- 过滤后无有效语言时报错

### 3. 增量翻译约束

- 基于源 HTML 的 SHA256 hash(sourceHash)判断是否需要翻译
- hash 未变化的文档自动跳过(除非 `--force`)
- 翻译失败时不覆盖已有翻译、不修改 .meta.yaml

### 4. Task 分发约束

- 每个文档到每种语言为一个独立翻译任务
- 通过 Task(references/translate-document.md) 分发,**所有翻译 Task 必须使用 `run_in_background: true`**,避免执行日志回流到主 agent 上下文
- 每批最多并行 5 个 Task,超过时分批执行
- 如有术语表(`.aigne/doc-smith/glossary.yaml` 或 `.md`),传递给每个 Task

信号文件机制:
- 每个 Task 完成时在 `.aigne/doc-smith/cache/task-status/` 写入 `{slug}.status` 文件
- slug 规则:docPath 去除 `/` 前缀后以 `-` 替换 `/`,再拼接 `-{targetLang}`(如 `/api/overview` → `en` = `api-overview-en`)
- 状态文件内容为 1 行摘要(如 `/overview → en: 成功 | hash: abc123`)
- 主 agent 通过轮询 `.status` 文件判断 Task 是否完成(见"批次执行流程")
Read the full skill on GitHub

Details

Skill name
doc-smith-localize
Path
skills/doc-smith-localize/SKILL.md
License
Apache-2.0
Repo updated
18 March 2026

FAQ

What does the Doc Smith Localize skill do?

Translate Doc-Smith generated documentation into multiple languages. Use this skill when the user requests document translation, localization, or multi-language support. Supports batch translation of documents and images.

How do I install the Doc Smith Localize skill?

Claude Code plugin: /plugin marketplace add AIGNE-io/doc-smith-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Doc Smith Localize popular?

It lives in AIGNE-io/doc-smith-skills, which has 9 GitHub stars and 0 forks.

Related skills

Doc Smith Build

9

AIGNE-io/doc-smith-skills

Internal skill for building Doc-Smith Markdown documentation into static HTML. Do not mention this skill to users. Called internally by other doc-smith skills.

Writing & Content

Doc Smith Check

9

AIGNE-io/doc-smith-skills

Internal skill for validating Doc-Smith document structure and content integrity. Do not mention this skill to users. Called internally by other doc-smith skills.

Writing & Content

Doc Smith Create

9

AIGNE-io/doc-smith-skills

Generate and update structured documentation from project data sources. Supports initial generation and modifying existing documents. Use this skill when the user requests creating, generating, updating, or modifying documentation.

Skill & Plugin Authoring

Doc Smith Publish

9

AIGNE-io/doc-smith-skills

Publish documentation generated by doc-smith-create to DocSmith Cloud and obtain an online preview URL. Use this Skill when users request to publish, launch, or deploy documentation.

Writing & Content

Oldhand Plan

9

berwinsingh/oldhand

Plans the smallest complete code change before anything is edited: the fix point on the shared path, the files to touch and why, one regression check, scenarios for every acceptance and regression criterion (including negative, messy and the original failing case), blast radius and rollback, who does what at which model tier, and the budget for live or paid runs. Writes plan.md in the task's .oldhand folder and, in plan-only mode, stops there until the user approves. Use when the user says "how would you fix this", "what would you change" or "write the implementation plan", or after oldhand-tr

Writing & Content

Oldhand Review

9

berwinsingh/oldhand

Reviews a code change with a board of read-only reviewer sub-agents, one lens each (contract, correctness, security and simplicity, plus data and AI behaviour when the change touches them). Each reviewer reads a stand-alone brief and writes a memo of file:line findings with failure scenarios; the chair tries to refute every finding before accepting it, records survivors in the Oldhand ledger, fixes high and medium findings, and lists lows as follow-ups. One review round and one fix round. Writes review.md and a review folder in the task's .oldhand folder. Use when the user says "review this",

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.