i18n Parity
A repo-specific rule set that forces every localization change to land on all five surfaces — UI keys, wiki, mirrored READMEs, language switchers, and locale formatting — in the same PR.
Dev & CodingAdvanced★ 979⑂ 229AI score 7/10Last updated: Sep 6, 2026
What it does
- Maps the repository's five localization surfaces in a table: UI keys in
client/src/i18n/locales/*, the wiki (wiki/index.html,script.js,i18n-content.js), mirrored READMEs (README-CN/VN/KO/ES.md), the language switchers, and locale-aware formatting informat.ts— each with its English source of truth, translation location, and automated gate. - States a single invariant: English is the source of truth, and nothing is done until every supported locale (
en, zh, vi, ko, es) carries the change in the same PR. English fallback is a safety net, not a translation. - Provides a "you changed X → you must also do Y" lookup table for adding keys, adding namespaces, adding wiki copy, editing the README, and changing documented counts.
- Spells out what must never be translated (code, paths, env vars, hook event names, the
Agenttool identifier) versus the per-locale UI-noun contract, and warns about two wiki test traps (source-marker parsing,localStorage["wiki-lang"]). - Ends with a runnable verification sequence:
i18n-audit.sh,npm run test:client, the wiki DOM vitest,npm run test:server, andnpm run format.
Who it's for
- Contributors to the Claude-Code-Agent-Monitor repo who touch user-visible copy, READMEs, or the wiki.
- Engineers who want a reference design for preventing half-translated releases across multiple localization surfaces.
- Anyone adding a brand-new locale who needs a mechanical, nothing-missed checklist.
Examples
- You add a new dashboard button label — the skill has you add the key to
enandzh/vi/ko/eswith identical key paths and{{interpolation}}tokens, then runnpm run test:client. - You edit the install section of
README.md— it requires mirroring the same edit into all four translated READMEs and verifying heading counts and cross-links withi18n-audit.sh. - You add a wiki paragraph — headings go into
T, body prose intowiki/i18n-content.js, attributes intoATTRIBUTE_TRANSLATIONS, plus aCACHE_NAMEand?v=bump so returning visitors actually see it.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/hoangsonww/Claude-Code-Agent-Monitor/HEAD/.agents/skills/i18n-parity/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .agents/skills/i18n-parity folder from the GitHub repo hoangsonww/Claude-Code-Agent-Monitor into my ~/.claude/skills/i18n-parity/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git && mkdir -p ~/.claude/skills && cp -r Claude-Code-Agent-Monitor/.agents/skills/i18n-parity ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repository that ships the skill:
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git - Create your personal skills directory:
mkdir -p ~/.claude/skills - Copy the skill folder:
cp -r Claude-Code-Agent-Monitor/.agents/skills/i18n-parity ~/.claude/skills/ - Confirm the referenced files
references/new-language-checklist.mdandreferences/translation-style.mdcame along; if not, copy them from.claude/skills/i18n-parity/in the repo. - Because the skill depends on this repo's paths and on
scripts/i18n-audit.sh, run Claude Code from inside that repository for it to be useful. - Restart Claude Code and try a prompt like "I added new UI copy — check i18n parity across all surfaces."
View source on GitHub ↗License: MIT