archflow-agent-i18n-engineer

Refactors hardcoded user-facing strings into the project's existing i18n mechanism and generates locale resource files.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-agent-i18n-engineer-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-agent-i18n-engineer
Source: https://github.com/AZidan/archflow/tree/main/adapters/generic/.agents/skills/archflow-agent-i18n-engineer
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-agent-i18n-engineer-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applications built with hardcoded text cannot be translated, and retrofitting internationalization by hand is error-prone: plurals get hand-branched, strings get concatenated, and RTL layouts break. This Skill systematically externalizes every user-facing string into the i18n mechanism the project already uses, so the app becomes translation-ready without adopting a new framework. ## Core Features & Use Cases - String extraction and refactoring: Scans source for hardcoded user-facing text, assigns semantic screen.component.element.purpose keys, and replaces literals with lookups through the platform's native i18n mechanism. - Locale resource generation: Produces base-locale resource files split by feature, with translator comments covering context, length limits, and variables, plus skeleton files for other locales. - Correctness rules for plurals, formatting, and RTL: Routes plurals through the platform's plural engine, formats dates and currency with locale-aware formatters, and uses logical start/end direction for RTL support. - Use Case: A team preparing their web app for a German and Arabic launch invokes this role to externalize all UI copy, generate the English resource files, and verify layouts survive 40% text expansion before handing off to QA. ## Quick Start Ask the agent to act as the i18n-engineer and externalize all hardcoded user-facing strings in the current project into its existing i18n framework, generating the base locale resource files.

Frequently Asked Questions about archflow-agent-i18n-engineer

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

FAQPage Schema
How do I refactor hardcoded strings for internationalization?

Scan source files for user-facing literals, assign each a semantic key like screen.component.element.purpose, then replace the literal with a lookup through your platform's i18n mechanism. Finally generate base-locale resource files and validate that no user-facing literal remains.

How should I name i18n keys for a large application?

Use hierarchical semantic keys describing where and what, such as login.form.email.placeholder, never the English text itself. Split resource files by feature with a shared common file, mirrored identically across locales so missing files are obvious.

Does this work with any i18n framework or tech stack?

Yes, it is stack-neutral and works in whatever framework the project declares, reading the stack from project settings or detecting it from the repo. It never installs a new i18n library and extends the existing mechanism rather than introducing a second one.

How do I handle plurals correctly when internationalizing?

Route plurals through the platform's native plural engine rather than conditional branches like if count equals one. Languages have up to six plural categories, so a hand-written branch is only correct in English.

What are the limitations of automated i18n refactoring?

It externalizes strings and wires the mechanism but does not translate content; translation remains the user's or a translator's job. Because it is a repo-wide change, it requires a full QA regression before approval to catch broken keys or stray literals.