Agent skill

Translation Diff Translate

by Devolutions in Devolutions/UniGetUI

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.

MITAuto-check passedWriting & Content

Install Translation Diff Translate

skills CLI
$ npx skills add Devolutions/UniGetUI --skill translation-diff-translate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Devolutions/UniGetUI translation-diff-translate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Devolutions/UniGetUI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/translation-diff-translate .claude/skills/translation-diff-translate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
translation-diff-translate
GitHub stars
26k
Token cost
~934 tokens
SKILL.md length
286 words
Files
2 (incl. scripts)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 5 steps: Edit .translated.json directly. Do not… → Do not install packages or search for… → If .translated.json is empty, that is… → …
  • The user asks to translate
  • SKILL.md covers Execution Expectations, Script, Usage and Translation Rules, plus 1 more section
  • Runs PowerShell scripts from its folder; calls pwsh

What it does

Translation Diff Translate is an agent skill from Devolutions/UniGetUI. 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.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts.

It sits in Writing & Content, covering Translation and Internationalization. It works with Windows. The repository describes itself as: UniGetUI: The Graphical Interface for your package managers. Could be terribly described as a package manager manager to manage your package managers. The licence is MIT.

When your agent uses it

  • The user asks to translate
  • Localize i18n strings
  • Localization JSON
  • Language-file patches

Example prompts

  • “Use the translation-diff-translate skill to translate a sparse UniGetUI JSON language patch, writes completed entries into the working copy…”
  • “/translation-diff-translate”

Requirements

  • PowerShell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Edit .translated.json directly. Do not create helper scripts, temporary reports, or coverage probes.
  2. Do not install packages or search for external translation services unless the user explicitly asks for automation.
  3. If .translated.json is empty, that is expected. Translate from .source.json into .translated.json.
  4. Use .reference.json only as terminology guidance, not as a reason to pause and analyze the rest of the repository.
  5. If the patch is too large to finish reasonably in one pass, report that constraint to the user instead of creating automation on your own.

What it can do on your machine

Read from SKILL.md and the folder at commit ea50508. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (PowerShell), which the agent can run.

    Shell commands in SKILL.md call:

    • pwsh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Translation Diff Translate loads about 934 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 286 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~934

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Devolutions/UniGetUI at commit ea50508, republished under its MIT licence (© Devolutions). 286 words, ~934 tokens.

Download SKILL.mdSave it as .claude/skills/translation-diff-translate/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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.

translation diff translate

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.

Execution Expectations

  1. Edit .translated.json directly. Do not create helper scripts, temporary reports, or coverage probes.
  2. Do not install packages or search for external translation services unless the user explicitly asks for automation.
  3. If .translated.json is empty, that is expected. Translate from .source.json into .translated.json.
  4. Use .reference.json only as terminology guidance, not as a reason to pause and analyze the rest of the repository.
  5. If the patch is too large to finish reasonably in one pass, report that constraint to the user instead of creating automation on your own.

Script

  • 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.

Usage

Generate a handoff prompt for a translated French working copy:

powershell
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

Translation Rules

  1. Do not edit .source.json.
  2. Write completed translations only into .translated.json.
  3. If a key is not translated yet, omit it from .translated.json instead of copying the English source value.
  4. Preserve key names exactly as-is.
  5. Preserve placeholders, named tokens, HTML-like fragments, escape sequences, and line breaks.
  6. Keep translated entries in the same key order as .source.json when adding new entries.
  7. Use .reference.json to match existing terminology and tone in the destination language.
  8. Do not introduce keys that are not present in the source patch.

After Translation

Merge the sparse working copy back into the full destination-language file:

powershell
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

© Devolutions, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in .agents/skills/translation-diff-translate of Devolutions/UniGetUI.

  • SKILL.md
  • scripts/write-translation-handoff.ps1

Open the folder on GitHubat commit ea50508

Compare with similar skills

Translation Diff Translate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Translation Diff Translate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Translation Diff Translate this skillDevolutions/UniGetUI26k—~934Automated safety check: PassMIT
Plane UI Translationmakeplane/plane60k—~16kAutomated safety check: PassAGPL-3.0
Translatetagspaces/tagspaces5.3k—~2.2kAutomated safety check: PassAGPL-3.0
Write Locale Translationsvideojs/video.js40k—~723Automated safety check: PassCustom licence
Roo Translationzgsm-ai/costrict4.4k—~1.8kAutomated safety check: PassApache-2.0
Update TranslationsRaicuparta/rai-pal732—~839Automated safety check: PassGPL-3.0

Similar skills

  • Plane UI Translation

    makeplane/plane

    Sets the rules for translating and updating Plane's UI strings across locales: do-not-translate terms, plural forms, placeholders and AI translation review.

    60k GitHub stars~16k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translate

    tagspaces/tagspaces

    Translate new or untranslated i18n strings from the English locale files (core.json + peri.json) into all other locales, maintaining consistency with each language's existing translations.

    5.3k GitHub stars~2.2k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translate or audit the values in a Video.js locale pack. An agent skill from videojs/video.js.

    40k GitHub stars~723 tokensUpdated today
    Writing & ContentAuto-check passed
  • Roo Translation

    zgsm-ai/costrict

    Provides comprehensive guidelines for translating and localizing CoStrict extension strings.

    4.4k GitHub stars~1.8k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Update Translations

    Raicuparta/rai-pal

    A skill your agent uses when asked to update translations, localize strings, add new languages, fix missing translation keys, or sync language files in this project.

    732 GitHub stars~839 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translate

    ankit/stylebot

    Translate Stylebot's locale strings — fill in strings that English has and other locales lack, retranslate English strings that changed, or add a whole new locale (e.g.

    1.6k GitHub stars~1.9k tokensUpdated today
    Writing & ContentAuto-check passed

More from Devolutions/UniGetUI

  • Translation Diff Export

    Devolutions/UniGetUI

    Compares UniGetUI JSON locale files against English, identifies untranslated or source-changed keys, and generates patch, reference, and handoff files for a target language.

    26k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Translation Diff Import

    Devolutions/UniGetUI

    Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result.

    26k GitHub stars~750 tokensUpdated yesterday
    Auto-check passed
  • Translation Review

    Devolutions/UniGetUI

    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…

    26k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Translation Source Sync

    Devolutions/UniGetUI

    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…

    26k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Translation Status

    Devolutions/UniGetUI

    Analyzes checked-in UniGetUI language files to calculate translation percentages, surface untranslated coverage data, and generate localization status reports.

    26k GitHub stars~505 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Translation Diff Translate

What does Translation Diff Translate do?

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. Translation Diff Translate is an agent skill from Devolutions/UniGetUI. 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.

When should I use Translation Diff Translate?

Translation Diff Translate fits situations like: the user asks to translate; localize i18n strings; localization JSON; language-file patches.

How do I install Translation Diff Translate in Claude Code?

Run `npx skills add Devolutions/UniGetUI --skill translation-diff-translate -a claude-code`. Or copy the skill folder (.agents/skills/translation-diff-translate in Devolutions/UniGetUI) into .claude/skills/translation-diff-translate in your project. Claude Code loads it when a task matches its description.

How do I install Translation Diff Translate in Codex?

Run `npx skills add Devolutions/UniGetUI --skill translation-diff-translate -a codex`. Or copy the skill folder (.agents/skills/translation-diff-translate in Devolutions/UniGetUI) into .agents/skills/translation-diff-translate in your project. Codex loads it when a task matches its description.

Can I use Translation Diff Translate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Devolutions/UniGetUI --skill translation-diff-translate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/translation-diff-translate, .gemini/skills/translation-diff-translate, .github/skills/translation-diff-translate and .opencode/skills/translation-diff-translate in your project.

What does Translation Diff Translate need to run?

Going by SKILL.md and its folder, Translation Diff Translate needs PowerShell for the scripts in its folder and the command-line tools its instructions call (pwsh). Our summary lists: PowerShell.

Does Translation Diff Translate access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Translation Diff Translate safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Translation Diff Translate use?

Translation Diff Translate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Translation Diff Translate use?

About 934 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Translation Diff Translate?

Skills that share tags, products or a category with Translation Diff Translate: Plane UI Translation (makeplane/plane, 60k stars), Translate (tagspaces/tagspaces, 5.3k stars), Write Locale Translations (videojs/video.js, 40k stars) and Roo Translation (zgsm-ai/costrict, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Translation Diff Translate?

Devolutions (a GitHub organization) maintains it in Devolutions/UniGetUI, which has 26,404 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 6, 2026.

Source: Devolutions/UniGetUI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.