Skip to content

feat(engineering): add i18n-localization plugin (#849) - #1095

Merged
alirezarezvani merged 1 commit into
devfrom
claude/project-thread-7nrqi1
Nov 2, 2026
Merged

alirezarezvani merged 1 commit into
devfrom
claude/project-thread-7nrqi1

Conversation

@alirezarezvani

Copy link
Copy Markdown
Owner

Requested by Reza · project thread

Summary

Adds engineering/i18n-localization, the top-ranked uncovered request from the issue backlog (#849). It ships three stdlib scripts, and each one has exit codes that can block a build:

  • locale_sync.py checks translation files against the source locale: missing or empty keys, changed placeholders, ICU syntax, plural/select without other, zero vs =0, and the plural categories each target locale needs. It uses an embedded CLDR 49 table. It reads JSON/ARB (i18next or ICU), .properties, Apple .strings, Android XML and gettext .po.
  • hardcoded_strings.py finds UI text that bypasses t() in React, Vue, Svelte and HTML. It also warns on concatenation and on date or number formatting that doesn't pass a locale. Supports --warn-only, .i18n-allow and i18n-ignore.
  • pseudo_localize.py generates en-XA and ar-XB (--bidi) pseudo-locales. Placeholders and ICU syntax are kept intact.

The plugin also includes:

  • the cs-i18n-engineer agent
  • the /cs-i18n-check and /cs-pseudo-locale commands
  • three references, each citing 7–8 sources
  • a CI job example

It is bundled in engineering-advanced-skills 2.14.15; the standalone plugin is at 2.14.7.

Eval (Claude Code headless, 3 runs per arm, with the skill vs without):

Fixture With skill Without
Easy, 5 planted defects 30/30 29/30 (the one miss was the grader's regex, so it's a tie)
Hard, 8 defects across en/de/fr/pl/ar/ja 24/24, $0.16, 97 s, 8.3 turns 24/24, $0.28, 131 s, 12 turns
  • The skill auto-triggered in 6 of 6 with-skill runs.
  • Neither arm reported false positives on the decoys.
  • The eval shows no quality lift. With the skill, runs are 43% cheaper and 26% faster, and the scripts give a deterministic CI gate.

On held-out repos (outline, documenso), hardcoded_strings.py had precision of TEXT 20/20, ATTR 17/20 and EXPR 15/20.

Checklist

  • No vendor or commercial API dependencies; stdlib only, no network
  • No claude- prefix, and no clash with Claude Code built-in names (check_skill_names.py --all)
  • The SKILL.md description is written as a trigger; listing budget G12 passes
  • Plugin versions are above dev (G11)
  • The mirror in engineering/skills/ is byte-identical (check_dual_publish.py)

Type of Change

  • New skill / plugin

Testing

These all pass locally:

  • check_plugin_json --all
  • check_plugin_versions --base origin/dev
  • check_dual_publish
  • check_paths --all
  • check_frontmatter --all
  • check_skill_names --all
  • check_command_refs
  • check_listing_budget
  • derive_counters --check
  • smoke_scripts: 787 passed, 0 failed
  • smoke_json_output
  • compileall
  • skill_security_auditor --strict: no issues

Generated by Claude Code

Three stdlib scripts with blocking exit codes for shipping a new language:
locale_sync.py (keys, placeholders, ICU syntax, CLDR 49 plural categories,
gettext), hardcoded_strings.py (UI text that bypasses t() in React/Vue/
Svelte/HTML) and pseudo_localize.py (en-XA / ar-XB pseudo-locales).
Agent cs-i18n-engineer, /cs-i18n-check and /cs-pseudo-locale, three
references, CI job example. Bundled in engineering-advanced-skills 2.14.15.

Eval, 3 runs per arm on 8 planted defects: 24/24 both arms; with the skill
43% cheaper and 26% faster. The value is a repeatable CI gate.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01L8KYFGuNUFriREtj1haTcG
@alirezarezvani alirezarezvani self-assigned this Nov 2, 2026
@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

🔒 Skill Security Audit Results

✅ engineering/i18n-localization/skills/i18n-localization — PASS

No findings.

✅ engineering/skills/i18n-localization — PASS

No findings.

@alirezarezvani
alirezarezvani marked this pull request as ready for review November 2, 2026 15:50
@alirezarezvani
alirezarezvani merged commit 1496a40 into dev Nov 2, 2026
9 checks passed
@alirezarezvani
alirezarezvani deleted the claude/project-thread-7nrqi1 branch November 2, 2026 15:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants