i18n-transform

Converts hardcoded UI and backend message strings into resource-file-driven i18n keys.

1|Updated Sep 11, 2026
One-click install
npx skills add https://github.com/lldwb/lldwb-claude-skills --skill i18n-transform-lldwb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: i18n-transform
Source: https://github.com/lldwb/lldwb-claude-skills/tree/main/skills/i18n-transform
Command: npx skills add https://github.com/lldwb/lldwb-claude-skills --skill i18n-transform-lldwb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hardcoded user-facing text scattered across backend messages, frontend pages, and validation annotations makes multi-language support error-prone and hard to audit. This Skill orchestrates a controlled transformation that replaces hardcoded copy with resource-file keys while guaranteeing zero business-logic changes. ## Core Features & Use Cases - Three transformation tracks: backend messages (error codes, exceptions, prompts), frontend copy (labels, buttons, placeholders, dialogs, breadcrumbs, options), and parameter validation annotation messages. - Orchestrated subagent pipeline: one file equals one transformation subagent, followed by independent read-only review subagents (fatal/warning grading) and validation subagents (key-set consistency, encoding, mapping completeness), with at most 2 repair rounds before escalating to a manual-intervention list. - Key conventions and reporting: enforces naming structure, prefix ownership, multi-language key-set parity, escaped non-Latin values, append-only resource edits with backups, and produces transformation reports plus new-key glossaries. - Use Case: Ask to internationalize a module; the Skill scans for hardcoded strings, confirms scope with you, dispatches per-file transformation agents, then reviews, validates, compiles, and commits the changes. ## Quick Start Use the i18n-transform skill to convert all hardcoded Chinese copy in the order-management module into resource file keys with English translations.

Frequently Asked Questions about i18n-transform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert hardcoded strings to i18n resource files?

Define the scope (backend messages, frontend copy, or validation messages), then scan for hardcoded strings and replace each with a generated key appended to all language resource files. This Skill automates that flow with per-file subagents, review, and validation stages.

How to internationalize validation annotation messages in Java?

Replace only the message attribute of validation annotations with a resource key, leaving min, max, groups, and regexp untouched. Replace literal numbers in messages with framework placeholders like {min} or {max} so the message stays generic.

Why do some pages show key names instead of translated text?

This happens when a key exists in source code but is missing from one or more language resource files, causing fallback to the raw key name. The fix is ensuring key sets are identical across all locale files, which the validation stage checks as a fatal issue.

Does this workflow modify business logic during i18n refactoring?

No. The transformation is restricted to copy and resource files only; method signatures, SQL, permission annotations, and validation parameters are explicitly forbidden from changes. Any business defect discovered during transformation is handed off to a separate bug-fix workflow.

When should I not use an automated i18n transformation workflow?

Avoid it when you only need to fix resource file formatting errors (use a small-scoped optimization instead), when adding new business behavior, or when translation quality of industry terminology must be judged, which requires human or business review.