i18n-checker
Skill1 starsChanged yesterdayMITView on GitHub
Find internationalisation and localisation problems in resource files, code and the running UI. Statically - missing, untranslated, empty, duplicate and unused keys, placeholders that differ between locales, broken ICU syntax, plural categories CLDR requires but a message lacks, hard-coded text, concatenated translations, hand-formatted numbers and dates, fixed widths and physical CSS that won't mirror. At runtime - pages rendered in a pseudo-locale (longer, accented, bracketed text), every shipped locale and RTL locales, measuring truncation, overlap, untranslated text, raw placeholders and keys, formats against CLDR, and mirroring. Proposes missing keys as a patch, never applies it, never sends text to outside services, and never calls a product fully localised, RTL-ready or ready for localisation. A product that ships one locale gets a readiness review, not an issues verdict.
- Installs packages
In this repository33 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- api-contract-testerSkill
- bug-reproducerSkill
- ci-failure-triagerSkill
- ci-suite-runnerSkill
- code-security-auditorSkill
- cross-browser-checkerSkill
- db-migration-reviewerSkill
- dead-test-finderSkill
- exploratory-charter-writerSkill
- flaky-test-hunterSkill
- hypercare-anomaly-watcherSkill
- journey-mapperSkill
- journey-to-testsSkill
- mobile-app-auditorSkill
- mutation-testerSkill
- performance-budget-auditorSkill
- post-deploy-validatorSkill
- privacy-flow-auditorSkill
- qa-orchestratorSkill
- release-readiness-gateSkill
- requirements-traceability-auditorSkill
- resilience-proberSkill
- risk-based-test-plannerSkill
- test-case-designerSkill
- test-data-auditorSkill
- test-impact-selectorSkill
- test-suite-evaluatorSkill
- ticket-readiness-reviewerSkill
- ticket-to-tddSkill
- ui-crash-hunterSkill
- visual-regression-reviewerSkill
- wcag-auditorSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 36
No outside services: No translation memory or machine translation: it would send product text to a third party.
- Distinctive: line 47
A single-locale product is a readiness review: When no locale ships besides the source (no second locale in any resource set and none …
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
i18n checker
Mission
Show where a product breaks in the languages it ships, with a file and line or a screenshot and a measurement for every finding. Separate what a parser proves (a missing key, a broken placeholder) from what a heuristic suggests (a hard-coded string) and confirm heuristics in the rendered UI. Say what wasn't checked; translation quality is always out of reach for tools.
The WCAG auditor checks the page language and reflow; this skill checks every shipped locale.
Non-negotiable rules
- Never "fully localised". The verdict is
issues_foundornone_detected, scoped to the locales, files and pages checked,readiness_onlyfor a single-locale product (rule 10), ornot_assessedwhen no resources were parsed, no code was read and nothing rendered: stop and say so, never a scopednone_detectedover an empty input. Never claim readiness: "RTL-ready" or "supports RTL" needs an RTL locale checked, and "ready for localisation", "localisation-ready" or "ready for any language" is never written (tools show problems, not readiness).translation_qualityisuntestedunless a named reviewer checked the translations ("Translations reviewed by ..." in limitations). - Missing is not untranslated. A key absent from a locale is
missing_key; a key present with the source text copied in isuntranslated, apossiblefinding that is never high confidence (some words are the same in both languages). - Evidence. Static findings have a file and line; runtime findings have a screenshot and a measurement (the element, its box, the pixels of overflow, the values against CLDR).
- Every locale is accounted for:
checked,not_runwith a reason, orexcludedwith a reason. - Report and propose, never apply. Missing keys become
missing_keys.patchwith the source text copied in for translation; resource files are never edited. - No outside services. No translation memory or machine translation: it would send product text to a third party.
- Safe targets (runtime): loopback needs nothing; other hosts need
authorised_by. - Record every tool (
ran,not_run,errored), including the project's own i18n linters. - Loud about what wasn't read.
discover.pylists files that look like resources but weren't parsed (not_parsed, including locale-named.jsfiles with no message object) and every skipped directory (skipped_dirs, also on stderr);scan_code.pyrecordsfiles_scanned. Put them inlimitations. A format this skill can't read is reported as not parsed, never silently ignored. The validator requires a limitation for each not_run or excluded locale (its code or name), for files not parsed, for a text-walk pseudo-locale, and for a product with no resource set or no second locale. - A single-locale product is a readiness review. When no locale ships besides the source (no
second locale in any resource set and none rendered;
candidates.jsonhassingle_locale: true), key, placeholder and plural checks have nothing to compare: say so. The verdict isreadiness_only(ornot_assessed), the summary says only one locale ships ("single-locale", "English only"), hard-coded text is Low (readiness for a future locale), and copy the owner may never translate goes toneeds_reviewrather than being dismissed or promoted wholesale. - Dismiss with a checkable reason. A dismissal names what makes it safe to drop (the text, the file or line, "a product name, never translated"); "false positive" or "not needed for this site" alone is rejected.
Inputs
| Input | Default | Notes |
repo | optional | Static checks |
targets | optional | targets.json: site, pages (critical_path), viewports, locales, rtl_locales, locale_strategy, resources |
source_locale | detected | en when present, else the locale with the most keys |
locales | all found | Locales that ship |
rtl_locales | ar, then he | Arabic is the main RTL run; Hebrew a second check |
pseudo | on | Expansion, accents, ⟦ ⟧ brackets |
allow_list | data/hardcoded-patterns.json | Text that is never translated (brand names, codes) |
authorised_by, auth | as in browser_harness.py | auth: {"storage_state": file} runs signed in, with a session a person captured by signing in by hand (python scripts/browser_harness.py capture-session --url <app> --out <file outside the repo>; cookies, localStorage, IndexedDB and sessionStorage); the run stays read-only and records only that a session was used, never the file or its contents |
At least one of repo and targets is required.
Workflow
Static scripts are stdlib; render_locales.py needs Playwright (pip install -r requirements.txt,
python -m playwright install chromium; ask first). CLDR data is committed and pinned.
python scripts/fetch_cldr.py --check # the pinned CLDR subsets are intact
python scripts/discover.py --repo <repo> --out <run>/resources.json # files, locales, source, library
python scripts/check_keys.py <run>/resources.json --repo <repo> --out <run>/keys.json
python scripts/scan_code.py --repo <repo> --out <run>/code.json
python scripts/render_locales.py targets.json --out <run>/runtime # source, pseudo, each locale, RTL
python scripts/merge_findings.py --resources <run>/resources.json --keys <run>/keys.json --code <run>/code.json \
--runtime <run>/runtime/runtime.json --repo <repo> --out <run>/candidates.json --patch <run>/missing_keys.patch- Discover. JSON (flat or nested; i18next plural suffixes), ARB, PO, Android
strings.xml(plurals,string-array), iOS.strings,.stringsdict,.xcstrings, and JS/TS message objects: a literal object of strings assigned to a translations-like name (const translations = {en: {...}, ru: {...}}, one set per object) or the default export of a locale-named module (locales/de.js). Values that aren't string literals are counted innot_parsed, never guessed; unused keys of a JS object are not assessed (its keys sit in the code). YAML is listed as not parsed. Each set (web, Android) is compared within itself.dist/,build/andout/are build output only when the repository builds them (a build script, a bundler config, a tsconfigoutDir, a.gitignoreentry); a committed, hand-written front end indist/that a server mounts as static files is scanned.--include DIRscans a skipped one. - Keys and messages. ICU syntax, placeholders of every style (ICU,
{{i18next}}, printf%1$s), CLDR plural categories, missing, untranslated, empty, duplicate and unused keys. Dynamic key prefixes (t('status.' + s)) make unused keys under themcantTell; a set whose platform has no code here is not assessed for unused keys. - Code. Hard-coded text in any script (HTML without a translation attribute, JSX/Vue text,
Android layouts, SwiftUI), concatenated translations, hand-formatted numbers, currency and dates, fixed widths that
hide overflow, physical CSS that won't mirror. All
possible. JSX (.jsx,.tsx, and.jsholding JSX) is read byscripts/jsx_text.py: element text in any script with digits and punctuation, kept whole beside{expressions}("Progress: {…}%"); the text attributesalt,aria-label,title,placeholderandlabel; Next.jsmetadataexports andgenerateMetadata()(titles and descriptions search results show). A JSX sentence that interleaves text with two or more expressions is a concatenation;{n}%is a hand-made percentage; a locale literal passed totoLocale*StringorIntl.*("en-GB") is a format finding; Tailwind physical utilities (ml-,pr-,left-,text-right,rounded-l, with variants such assm:) and arrows drawn as text (→,→) arertl_physical. The visually-hidden idiom (.sr-only: a 1px box withclip/clip-path) is never a fixed width. A service worker (public/sw.js;swis also Swahili) is never a locale resource:discover.pylists it underservice_workers. - Runtime. Pseudo-localisation rewrites the source resource file as it is served (or walks text
nodes when there's no resource file, which misses attributes and later text, and brackets
hard-coded text too, so it cannot find untranslated text:
pseudo.untranslated_checkis thennot_assessedand the evidence partial). On a product with no i18n library or resource file the text walk is the only possible mode, so untranslated text stays not assessed however often it runs (pseudo.only_mode); say so up front and still use the run for expansion (truncation, overlap). Visually-hidden text (sr-only skip links, route announcers) is not measured. Each locale is loaded with the site's locale strategy (query, cookie, path prefix or Accept-Language). In each real locale run,<html lang>naming another language and text left exactly as the source showed it areuntranslated(never high confidence); placeholders and button values wider than their input aretruncation; overlap is measured on line boxes, so wrapped inline links are not reported. Without aresourcespattern pass--resources <run>/resources.jsonso only shipped locales render; otherwise an RTL locale listed only inrtl_localesisnot_runrather than rendering the source text as RTL. - Merge and link. Runtime findings confirm static causes; ratings follow
RUBRIC.md. - Triage. Promote,
needs_review(anuntranslatedvalue that may be correct goes to a reviewer), or dismiss with a checkable reason (placeholder text a script replaces at runtime, shown translated in the pseudo run; a product name that is never translated). Counts in the summary ("14 issues", "55 need review") must match the report. For each finding write a title, a remediation naming the file and the fix (a key, a placeholder,Intl.NumberFormat, a logical CSS property), and a verification step. Problems found by reading the code that no candidate covers (a language switch that never updates<html lang>, a message built with markup) are findings with"source": "agent","candidate_id": nulland abasis[{file, line, excerpt}]that--repore-reads; never high confidence. - Validate and render.
python scripts/validate_report.py <run>/report.json --candidates <run>/candidates.json --keys <run>/keys.json \
--resources <run>/resources.json --repo <repo> --runtime <run>/runtime/runtime.json [--write-summary]
python scripts/render_report.py <run>/report.json [--brief]--brief prints the verdict, one line per finding, the items that need review (the first 15, then a
count) and the limitations.
Native mobile screens are not rendered here (the mobile app auditor does that); Android and iOS resources are checked statically, and mobile web at mobile viewports.
Output fields
scope: repo, site, pages, viewports, source locale, every locale with status and reason, RTL locales, pseudo expansion and method.metadata: library, tools, CLDR version and subset hashes.headline: verdict (issues_found,none_detected,readiness_only,not_assessed), summary, severity counts, key coverage per set and locale,translation_quality, evidence completeness, overall confidence.findings[]: kind, status, locales, severity, confidence, priority, score, reach, leverage, locations, keys, runtime evidence, remediation, verification step; agent findings addsourceandbasis.proposed_patch(applied: false),needs_review[],triage[],limitations[].
What the validator enforces
Findings match their candidates; static findings point at real lines; runtime findings have a
screenshot on disk and a measurement; every shipped locale has a status, and not_run ones a reason;
no "fully localised" claims, no "RTL-ready" without an RTL locale checked, no "ready for
localisation" at all; dismissals with a checkable reason; summary counts equal to the report's;
limitations naming not_run locales, unparsed files, a text walk and a missing resource set or second
locale; readiness_only for a single-locale product; translation quality untested without a named reviewer; untranslated
findings never high confidence; the patch is unapplied and matches the missing JSON keys; agent
findings have a basis that is on its line; the headline is recomputed. Evidence is partial when a
locale wasn't checked, something needs review, unused keys weren't assessed, a file wasn't parsed, no
resource set was found, the code scan read nothing, the pseudo run was a text walk, or the product
is single-locale; with nothing
analysed at all the verdict is not_assessed and confidence low. A headline more cautious than the
computed one is accepted.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

