Agent skill

Viewer i18n Translator

by liaohch3 in liaohch3/claude-tap

Fills missing translations in claude-tap's viewer_i18n.json by sending untranslated keys to OpenRouter for Japanese, Korean, French, Arabic, German and Russian.

MITAuto-check passedFrontend & Design

Install Viewer i18n Translator

skills CLI
$ npx skills add liaohch3/claude-tap --skill translate-i18n -a claude-code

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

GitHub CLI
$ gh skill install liaohch3/claude-tap translate-i18n --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/liaohch3/claude-tap.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/translate-i18n .claude/skills/translate-i18n && 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-i18n
GitHub stars
3.3k
Token cost
~666 tokens
SKILL.md length
290 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Fills missing translations in claude-tap's viewer_i18n.json by sending untranslated keys to OpenRouter for Japanese, Korean, French, Arabic, German and Russian.

  • Works in 3 steps: Check what's missing (dry run) → Run the translation → Verify the result
  • Adding a new UI string to the claude-tap viewer
  • SKILL.md covers Prerequisites, Workflow, Options and How it works, plus 1 more section
  • Calls uv; needs OPENROUTER_API_KEY

What it does

This skill is for the claude-tap project's viewer strings. After English or Chinese UI text changes in claude_tap/viewer_i18n.json, it finds keys present in both the en and zh-CN blocks but missing from the other languages and translates them through OpenRouter, defaulting to the google/gemini-2.5-flash model. The steps are a dry run first, then the real run that writes back into the JSON file in place, then a JSON syntax check and the project's pytest test.

The script checks that every language block is a string-to-string map, includes existing translations in its prompt for consistency, normalizes fullwidth punctuation for CJK languages to match the zh-CN style and inserts new entries after the existing keys. Flags include --dry-run, --model, --target, --file and --object-name. It only fills missing keys, so changing an existing string means deleting it from the target blocks before rerunning. OPENROUTER_API_KEY must be set in the environment.

When your agent uses it

  • Adding a new UI string to the claude-tap viewer
  • Checking which translation keys are missing with a dry run
  • Re-translating a changed string after removing it from the target languages

Example prompts

  • “I added a new label to viewer_i18n.json, so fill in the other languages.”
  • “Do a dry run of the i18n translation to see which keys are missing.”
  • “Re-translate the changed export button text into every target language.”

Requirements

  • An OPENROUTER_API_KEY environment variable
  • uv and the project's Python environment
  • The repository's scripts/translate_i18n.py script

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Check what's missing (dry run)
  2. Run the translation
  3. Verify the result

What it can do on your machine

Read from SKILL.md and the folder at commit e17ed32. 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:

    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use uv, 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 these keys or tokens, usually read from environment variables:

    • OPENROUTER_API_KEY

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

Context cost

Viewer i18n Translator loads about 666 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 290 words of instructions outside code blocks.

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

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 liaohch3/claude-tap at commit e17ed32, republished under its MIT licence (© liaohch3). 290 words, ~666 tokens.

Download SKILL.mdSave it as .claude/skills/translate-i18n/SKILL.md (or your agent's skills folder).
name
translate-i18n
description
Fill missing i18n translations in the viewer source JSON. Run this after adding or modifying English or Chinese UI strings in claude_tap/viewer_i18n.json — it auto-translates to ja, ko, fr, ar, de, ru via OpenRouter.
user_invocable
true

Translate i18n

Automatically fill missing translations for the viewer's claude_tap/viewer_i18n.json source file. The script uses English and Chinese as source languages and translates to Japanese, Korean, French, Arabic, German, and Russian.

Prerequisites

  • OPENROUTER_API_KEY must be set in the environment (it is in the user's .zshrc)
  • Default model: google/gemini-2.5-flash

Workflow

1. Check what's missing (dry run)

Always preview first to confirm which keys need translation:

bash
uv run python scripts/translate_i18n.py --dry-run

This parses claude_tap/viewer_i18n.json, finds keys present in both en and zh-CN but missing in other languages, and lists them without modifying the file.

2. Run the translation
bash
uv run python scripts/translate_i18n.py

The script calls OpenRouter once per target language, then writes the translations back into viewer_i18n.json in-place.

3. Verify the result

After translation, run the formatter and tests to make sure nothing broke:

bash
uv run python -m json.tool claude_tap/viewer_i18n.json >/dev/null
uv run pytest tests/test_translate_i18n.py -v

Options

FlagPurpose
--dry-runShow missing keys only, no file changes
--model MODELOverride the OpenRouter model (default: google/gemini-2.5-flash)
--target {viewer,cli}Translation target preset (default: viewer)
--file PATHOverride target file path
--object-name NAMEOverride the legacy JS/Python i18n object name

How it works

The script:

  1. Loads the viewer i18n JSON source file
  2. Validates that every language block is a string-to-string map
  3. Identifies keys present in en + zh-CN but missing in target languages
  4. Sends a structured prompt to OpenRouter with existing translations for consistency
  5. Normalizes fullwidth punctuation for CJK languages (matching zh-CN style)
  6. Inserts new entries after the existing keys in each target language

Common scenarios

Added a new UI string: Add the key to both en and zh-CN blocks in claude_tap/viewer_i18n.json, then run this skill. The other 6 languages will be filled automatically.

Changed an existing string: The script only fills missing keys. To re-translate an existing key, first delete it from the target language blocks, then run the script.

© liaohch3, 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-i18n of liaohch3/claude-tap.

Open the folder on GitHubat commit e17ed32

Compare with similar skills

Viewer i18n Translator 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.

Viewer i18n Translator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Viewer i18n Translator this skillliaohch3/claude-tap3.3k—~666Automated safety check: PassMIT
Claude Desktop Chinese Localizationjavaht/claude-desktop-zh-cn7.5k—~1.6kAutomated safety check: PassMIT
Ok Script I18nAliceJump/ok-end-field555—~828Automated safety check: PassAGPL-3.0
Fluent MigrationBrowserWorks/waterfox-android3791 repos~4.2kAutomated safety check: PassCustom licence
Ok Script I18nbaoxin1100/ok-kes101—~903Automated safety check: PassNone
I18nbrickbots/PiFinder250—~2.8kAutomated safety check: PassGPL-3.0

Similar skills

  • 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 6 days ago
    Frontend & DesignAuto-check passed
  • Ok Script I18n

    AliceJump/ok-end-field

    Maintain gettext translations for ok-script task UI and runtime messages.

    555 GitHub stars~828 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Fluent Migration

    BrowserWorks/waterfox-android

    A skill your agent uses when a patch or local changes rename, restructure, move, or replace Fluent (.ftl) strings - or migrate legacy .properties strings to Fluent - and you need a migration recipe…

    379 GitHub starsUsed in 1 repo~4.2k tokens
    Frontend & DesignAuto-check passed
  • Ok Script I18n

    baoxin1100/ok-kes

    Add, sync, repair, and compile gettext translations for ok-script Python task classes and task metadata.

    101 GitHub stars~903 tokensUpdated 10 days ago
    Frontend & DesignAuto-check passed
  • I18n

    brickbots/PiFinder

    PiFinder's internationalization (i18n) workflow — marking strings for translation, running the Babel extract/update/compile pipeline, adding or updating language translations, and filling in missing…

    250 GitHub stars~2.8k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Frappe Core Translation

    Impertio-Studio/Frappe_Claude_Skill_Package

    A skill your agent uses when implementing translations/i18n in Frappe v14-v16 apps.

    189 GitHub stars~1.9k tokensUpdated 24 days ago
    Writing & ContentAuto-check passed

More from liaohch3/claude-tap

All 11 skills in this repo
  • Codex E2E Trace Validation

    liaohch3/claude-tap

    Runs a real Codex CLI session through claude-tap and produces trace evidence and viewer screenshots for pull requests that touch capture, proxying or the viewer.

    3.3k GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Terminal Demo Video Recorder

    liaohch3/claude-tap

    Records a real tmux end-to-end run with asciinema, converts it to a GIF and MP4, and captures trace viewer screenshots with Playwright.

    3.3k GitHub stars~545 tokensUpdated yesterday
    Auto-check passed
  • JS-in-HTML Testing

    liaohch3/claude-tap

    Tests JavaScript embedded in an HTML file in two layers: pytest checks of the logic ported to Python, and Playwright runs in a real browser for the DOM.

    3.3k GitHub stars~924 tokensUpdated yesterday
    Auto-check passed
  • Runs local checks on maintainer docs for stale review dates, missing manifest paths and plan state drift, matching what the CI workflow enforces.

    3.3k GitHub stars~561 tokensUpdated yesterday
    Auto-check passed
  • Playwright Screen Recording

    liaohch3/claude-tap

    Records headless Playwright sessions as .webm videos to show a bug fix working or to give pull request reviewers visual evidence.

    3.3k GitHub stars~714 tokensUpdated yesterday
    Auto-check passed
  • PR Preflight Check

    liaohch3/claude-tap

    Runs a single merge-readiness check on a pull request: metadata, GitHub Actions status, local lint, format and test gates, and PR body rules, ending in READY or NOT_READY.

    3.3k GitHub stars~615 tokensUpdated yesterday
    Auto-check passed

Questions about Viewer i18n Translator

What does Viewer i18n Translator do?

Fills missing translations in claude-tap's viewer_i18n.json by sending untranslated keys to OpenRouter for Japanese, Korean, French, Arabic, German and Russian. This skill is for the claude-tap project's viewer strings.5-flash model.

When should I use Viewer i18n Translator?

Viewer i18n Translator fits situations like: adding a new UI string to the claude-tap viewer; checking which translation keys are missing with a dry run; re-translating a changed string after removing it from the target languages.

How do I install Viewer i18n Translator in Claude Code?

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

How do I install Viewer i18n Translator in Codex?

Run `npx skills add liaohch3/claude-tap --skill translate-i18n -a codex`. Or copy the skill folder (.agents/skills/translate-i18n in liaohch3/claude-tap) into .agents/skills/translate-i18n in your project. Codex loads it when a task matches its description.

Can I use Viewer i18n Translator 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 liaohch3/claude-tap --skill translate-i18n -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-i18n, .gemini/skills/translate-i18n, .github/skills/translate-i18n and .opencode/skills/translate-i18n in your project.

What does Viewer i18n Translator need to run?

Going by SKILL.md and its folder, Viewer i18n Translator needs the command-line tools its instructions call (uv) and credentials named OPENROUTER_API_KEY. Our summary lists: An OPENROUTER_API_KEY environment variable; uv and the project's Python environment; The repository's scripts/translate_i18n.py script.

Does Viewer i18n Translator access the network?

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

Is Viewer i18n Translator 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 Viewer i18n Translator use?

Viewer i18n Translator 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 Viewer i18n Translator use?

About 666 tokens (SKILL.md is roughly 2.7k 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 Viewer i18n Translator?

Skills that share tags, products or a category with Viewer i18n Translator: Claude Desktop Chinese Localization (javaht/claude-desktop-zh-cn, 7.5k stars), Ok Script I18n (AliceJump/ok-end-field, 555 stars), Fluent Migration (BrowserWorks/waterfox-android, 379 stars) and Ok Script I18n (baoxin1100/ok-kes, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Viewer i18n Translator?

liaohch3 (a GitHub user) maintains it in liaohch3/claude-tap, which has 3,271 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 10, 2026.

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