// Translates a sparse UniGetUI JSON language patch, writes completed entries into the working copy, preserves placeholders and terminology, and prepares the patch for merge-back. Use when the user asks to translate or localize i18n strings, localization JSON, or language-file patches.
Synchronizes the UniGetUI English language file with source-code usage, identifies missing translation keys, removes unused entries, reports localization drift, and can reorder locale files to match the English key ordering. Use when the user asks to sync language files, missing translations, i18n drift, or align locale file ordering with English.
Analyzes checked-in UniGetUI language files to calculate translation percentages, surface untranslated coverage data, and generate localization status reports.
Compares UniGetUI JSON locale files against English, identifies untranslated or source-changed keys, and generates patch, reference, and handoff files for a target language. Use when the user asks to export missing translations, untranslated strings, i18n diffs, or locale-file changes.
Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result. Use when the user asks to apply, merge, or import a translation patch.
Reviews UniGetUI .json language files for localization quality, detects parity issues, English-equal entries, wrong-script content, and cross-language outliers, then generates a dataset for LLM-assisted linguistic review. Use when the user asks to review translations, audit localization, inspect i18n or l10n quality, or validate language files.
| name | translation-diff-translate |
| description | Translates a sparse UniGetUI JSON language patch, writes completed entries into the working copy, preserves placeholders and terminology, and prepares the patch for merge-back. Use when the user asks to translate or localize i18n strings, localization JSON, or language-file patches. |
Use this skill after translation-diff-export produced a .source.json, .translated.json, and .reference.json set and you want to update the sparse translated working copy.
It translates only the active patch keys, keeps .translated.json as the sole writable file, preserves placeholders and formatting, and hands the completed working copy to translation-diff-import for merge-back.
.translated.json directly. Do not create helper scripts, temporary reports, or coverage probes..translated.json is empty, that is expected. Translate from .source.json into .translated.json..reference.json only as terminology guidance, not as a reason to pause and analyze the rest of the repository.scripts/write-translation-handoff.ps1: Writes a small .prompt.md file that points an agent at this skill with the concrete patch paths created by the export skill.Generate a handoff prompt for a translated French working copy:
pwsh ./.agents/skills/translation-diff-translate/scripts/write-translation-handoff.ps1 \
-BaseName lang \
-Language fr \
-SourcePatch ./generated/translation-diff-export/lang.diff.fr.source.json \
-TranslatedPatch ./generated/translation-diff-export/lang.diff.fr.translated.json \
-ReferencePatch ./generated/translation-diff-export/lang.diff.fr.reference.json \
-TargetJson ./src/Languages/lang_fr.json \
-NeutralJson ./src/Languages/lang_en.json \
-MergedTargetJson ./src/Languages/lang_fr.merged.json \
-ValidationScript ./.agents/skills/translation-diff-import/scripts/validate-language-file.ps1 \
-OutputPrompt ./generated/translation-diff-export/lang.diff.fr.prompt.md
.source.json..translated.json..translated.json instead of copying the English source value..source.json when adding new entries..reference.json to match existing terminology and tone in the destination language.Merge the sparse working copy back into the full destination-language file:
pwsh ./.agents/skills/translation-diff-import/scripts/import-translation-diff.ps1 \
-TranslatedPatch ./generated/translation-diff-export/lang.diff.fr.translated.json \
-SourcePatch ./generated/translation-diff-export/lang.diff.fr.source.json \
-TargetJson ./src/Languages/lang_fr.json \
-NeutralJson ./src/Languages/lang_en.json \
-OutputJson ./src/Languages/lang_fr.merged.json
pwsh ./.agents/skills/translation-diff-import/scripts/validate-language-file.ps1 \
-NeutralJson ./src/Languages/lang_en.json \
-TargetJson ./src/Languages/lang_fr.merged.json \
-PatchJson ./generated/translation-diff-export/lang.diff.fr.source.json