- Home
- Skills
- Translation & Localization
- Translation Files Check
More screenshots
Works with the AI Agents you already use
Translation Files Check
This skill finds those mistakes, and the quieter gaps such as missing keys, copied English text and Arabic plurals with only one and other, before you ship.
$5
Translation Files Check
Example session with this skill installed
Check this project with translation-files-check.
- Read your context and instructions
- Compiled the translation files check
$ python3 scripts/check_i18n.py examples/risky
Note: Base for android/app/src/main/res/values*/: android/app/src/main/res/values/strings.xml (default file, no language in its name), compared with 2 other files.
Note: Base for web/messages/.json: web/messages/en.json (en), compared with 2 other files.
Note: Base for backend/src/main/resources/messages.properties: backend/src/main/resources/messages.properties (default file, no language in its name), compared with 1 other file.
Note: ios/Souq/.lproj/Localizable.strings: not compared, because ios/Souq/ar.lproj/Localizable.strings could not be read.
Note: Base for config/locales/.yml: config/locales/en.yml (en), compared with 1 other file.
Note: gettext .po files: each msgstr was compared with its own msgid.
BLOCK android/app/src/main/res/values-fr/strings.xml:5 I02 INVALID_FILE
BLOCK api/locale/ar/LC_MESSAGES/django.po:11 I01 PLACEHOLDER_MISMATCH
BLOCK backend/src/main/resources/messages_fr.properties:3 I04 APOSTROPHE_HIDES_PLACEHOLDER
BLOCK ios/Souq/ar.lproj/Localizable.strings:2 I02 INVALID_FILE
BLOCK web/messages/ar.json:9 I01 PLACEHOLDER_MISMATCH
BLOCK web/messages/ar.json:15 I05 SCRIPT_IN_TRANSLATION
BLOCK web/messages/de.json:9 I03 BROKEN_PLURAL_OR_ICU
BLOCK web/messages/de.json:16 I04 APOSTROPHE_HIDES_PLACEHOLDER
REVIEW api/locale/ar/LC_MESSAGES/django.po:14 I18 FUZZY_TRANSLATION
REVIEW api/locale/ar/LC_MESSAGES/django.po:22 I17 PLURAL_FORMS_INCOMPLETE
REVIEW config/locales/ar.yml:1 I19 LOCALE_MISMATCH
REVIEW web/messages/ar.json I11 MISSING_KEY
REVIEW web/messages/ar.json:4 I13 EMPTY_VALUE
REVIEW web/messages/ar.json:8 I17 PLURAL_FORMS_INCOMPLETE
REVIEW web/messages/ar.json:10 I14 UNTRANSLATED
REVIEW web/messages/ar.json:11 I15 HTML_TAGS_DIFFER
REVIEW web/messages/ar.json:12 I16 DUPLICATE_KEY
REVIEW web/messages/ar.json:15 I15 HTML_TAGS_DIFFER
REVIEW web/messages/ar.json:17 I12 EXTRA_KEY
(Each finding also has Why and Safer lines, as in the first one.)
Verdict: BLOCK. Checked 13 files, 13 with translation content.
This is a static check of file text. NOT FLAGGED is not a guarantee.
Connects securely to your tools. The creator never sees your data.
About this skill
One translator turns {name} into {nom}, writes L'application in an Android strings.xml, or drops the other branch of an ICU plural, and the app shows a raw placeholder, the build stops, or a screen fails for every user of that language. This skill finds those mistakes, and the quieter gaps such as missing keys, copied English text and Arabic plurals with only one and other, before you ship.
Your agent runs a scanner on your project. It reads locale JSON (i18next, next-intl, vue-i18n, react-intl, Laravel, Chrome extensions), Rails and Symfony YAML, gettext .po, Flutter .arb, Apple .strings and .stringsdict, Android res/values XML and Java .properties. It groups the files that translate each other, picks the base language from file and folder names (en, en-US, values/, a bundle without a language suffix, or the Flutter template file), says which base it used, and compares every other language with it. It reads ICU MessageFormat, knows the CLDR plural forms of each language and the placeholder style of each format, tells a real plural set from an ordinary key such as payment.other, reads 100%ige as text rather than a placeholder, and handles Arabic and other right-to-left text. It never runs your app or a translation tool. It returns BLOCK, REVIEW, or NOT FLAGGED, with the file, line, reason, and a safer approach. Secrets are never printed.
What it checks
BLOCK
- I01: placeholders that differ from the base text ({name}, {{count}}, %s, %1$d, %(name)s, %@, {0}), including a changed type such as %d to %s, a plural form that drops an argument other than the count, and an ICU plural that never shows its number
- I02: files that will not load or build: JSON, YAML, .po and .strings syntax errors, duplicate msgids, duplicate keys in Symfony YAML, unescaped Android apostrophes, duplicate Android resources, ARB @@locale mismatches
- I03: ICU messages that cannot be read (unbalanced braces, no other option, unknown plural category) and plural sets without other
- I04: apostrophes that make {0} or {name} print as written in Java MessageFormat and ICU messages
- I05: script tags, event handlers or javascript: links inside a translation
REVIEW
- I11: keys missing from a translation
- I12: keys the base file does not have
- I13: empty translations
- I14: text copied unchanged from the base language
- I15: HTML or rich-text tags that differ from the base text
- I16: keys written twice in one file
- I17: plural forms a language needs (Arabic, Russian, Polish and others), and .po plural counts that differ from nplurals
- I18: fuzzy .po entries
- I19: a Rails root key or .po Language header that names another language than the file
What's included
- The scanner (Python 3.9+, standard library only)
- A rules guide with the reason and safer approach for each rule
- A risky and a safe example project (web, Android, iOS, Django, Rails and Spring files with Arabic, German and French translations), and the real report the scanner produces on the risky one
Limits It reads each file as written: translations loaded at run time, keys built in code, and whether the app renders a message as text or HTML are not checked. Each file is compared only with the base file of its own group, so keys moved between files show as missing and extra. XLIFF, .resx, .xcstrings, Qt .ts, JSON5 and TOML locale files are not read. Untranslated text is found by a heuristic. NOT FLAGGED is not a guarantee.
Static check of file text. Run-time translations, XLIFF, .resx and .xcstrings files, and keys moved between files are not handled. NOT FLAGGED is not a guarantee.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 5 days ago
Permissions
Runs one local Python script in the terminal. It reads your project's files, writes nothing, and makes no network calls. The risky example includes an inert onerror sample inside a translation and a clearly fake Android key (NOTREAL) for the scanner to find. Nothing is run.