i18n-expert

The i18n-expert skill is a specialized engineering companion designed to streamline the internationalization (i18n) and localization (l10n) lifecycle. It is ideal for teams working with React, Next.js, or Vue who need to transition from hard-coded UI text to a robust, scalable multi-language architecture. By combining static analysis, automated auditing, and standard-compliant file management, the skill removes the manual burden of keeping translation keys in sync with code changes.

• Framework-specific bootstrapping for libraries like react-i18next, next-intl, and vue-i18n, including provider wiring and routing integration.

• Automated audit pass using custom Python scripts to identify missing keys, parse dynamic t() calls, and detect hard-coded strings in JSX, TSX, and standard JS components.

• Intelligent string extraction and replacement workflow that safely migrates UI elements to structured namespaces (e.g., common, errors, buttons).

• Comprehensive locale parity checking to ensure en-US, zh-CN, and other target locales remain perfectly aligned, including pluralization (one/other) and formatting rule validation.

• Accessibility-first localization covering aria-labels, placeholder text, and component titles to maintain SEO and usability standards across different languages.

• Critical error-handling strategies that ensure raw system error messages are never exposed, replacing them with localized, user-friendly equivalents.

• Supported formats include JSON, YAML, PO, and XLIFF, with a default focus on structured JSON namespaces.

• Requires identification of the target i18n framework and existing locale directory structure prior to execution.

• Optimized for developers seeking to implement or upgrade their i18n strategy without sacrificing performance or code quality.

• Incorporates best practices for lazy-loading bundles and handling dynamic variables within translation strings to maintain app speed.

• Strict enforcement of placeholders to prevent breakages during translation generation, whether using AI, manual, or professional services.