translation-add-language

Creates a new target language translation file and populates it with translated keys.

3|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill translation-add-language-jose-polanco-oxte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translation-add-language
Source: https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer/tree/main/.agents/skills/localization/sub-skills/software-localization/translation-add-language
Command: npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill translation-add-language-jose-polanco-oxte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new language to a software project normally requires manually creating locale files, copying every source key, translating each string, and updating configuration. This Skill automates that entire onboarding workflow in one step. ## Core Features & Use Cases - Language Validation: Resolves full language names to BCP-47 codes (e.g., "Japanese" to "ja") and detects duplicates before creating files. - Automatic File Creation: Matches the project's existing translation file patterns (flat JSON, per-language directories, or module-based layouts) and formats (JSON, YAML, PO). - AI Translation or Empty Templates: Translates all source keys while preserving variables, or generates empty values with the --empty flag for human translators. - Config Updates: Adds the new language to targetLanguages in .translation-sync.json. - Use Case: A developer wants to ship their app in Japanese. They invoke the Skill with "ja", and it creates src/i18n/ja.json with all 142 keys translated, variables preserved, and the config updated. ## Quick Start Add Japanese as a new target language to this project and translate all keys from the English source file.

Frequently Asked Questions about translation-add-language

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

FAQPage Schema
How do I add a new language to my project's translation files?

Invoke the Skill with a BCP-47 code like "ja" or a full name like "Japanese". It validates the code, creates the translation file matching your existing directory pattern, translates all source keys, and updates the config.

How to create empty translation files for human translators?

Pass the --empty flag with the language code, for example "fr --empty". The Skill creates the file with all source keys present but empty string values, ready for manual translation.

What translation file formats does adding a language support?

The Skill detects and matches your project's existing format, including JSON, YAML, and PO files. It also supports flat per-language files, per-language directories with messages.json, and module-based layouts.

What happens if the language already exists in the project?

The Skill checks for an existing translation file before creating anything. If the language is already present, it informs you and suggests running translation-sync instead to update existing keys.

Does adding a language preserve variables in translated strings?

Yes, all placeholder variables from the source language are preserved during translation. The Skill also respects customInstructions from the config and formality rules from a translation style guide if one exists.