Agent skill

Translation Diff Import

by Devolutions in Devolutions/UniGetUI

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

MITAuto-check passedWriting & Content

Install Translation Diff Import

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

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

GitHub CLI
$ gh skill install Devolutions/UniGetUI translation-diff-import --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-import .claude/skills/translation-diff-import && 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-import
GitHub stars
26k
Token cost
~750 tokens
SKILL.md length
233 words
Files
3 (incl. scripts)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

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

  • The user asks to apply
  • SKILL.md covers Prerequisites, Scripts, Usage and Output, plus 1 more section
  • Runs PowerShell scripts from its folder; calls pwsh
  • Import a translation patch

What it does

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

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 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 apply
  • Import a translation patch

Example prompts

  • “Use the translation-diff-import skill to merge translated key-value pairs from a UniGetUI JSON localization patch back into the full language file…”
  • “/translation-diff-import”

Requirements

  • PowerShell

What it can do on your machine

Read from SKILL.md and the folder at commit ce0589d. 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 2 files 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 Import loads about 750 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 233 words of instructions outside code blocks.

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

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 ce0589d, republished under its MIT licence (© Devolutions). 233 words, ~750 tokens.

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

translation diff import

Use this skill after the export skill produced a .source.json, .translated.json, and .reference.json set and you want to merge the translated working copy back into the full target-language JSON file.

See translation-diff-export for the patch-generation step that produces the expected inputs.

Prerequisites

  • PowerShell 7 (pwsh).
  • cirup available on PATH.

Scripts

  • scripts/import-translation-diff.ps1: Validates and merges a translated patch into the full language file.
  • scripts/validate-language-file.ps1: Validates placeholder, token, HTML-fragment, and newline parity for either a full language file or just the active patch keys against lang_en.json.

Usage

Import the translated French working copy from the export skill into the full French JSON 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

Validate the merged output:

powershell
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

Optional parameters:

  • -OutputDir (default: generated/translation-diff-import)
  • -AllowUnchangedValues
  • -KeepIntermediate

Recommended input mapping from the export skill:

  • -TranslatedPatch: generated/translation-diff-export/lang.diff.fr.translated.json
  • -SourcePatch: generated/translation-diff-export/lang.diff.fr.source.json

Output

  • A merged .json file that contains both the previously translated entries and the imported patch values.
  • If -KeepIntermediate is used, patch snapshots are preserved under generated/translation-diff-import/tmp/.

Edge cases

  • If the target JSON file does not exist yet, the script can create an output from the translated patch alone.
  • When -SourcePatch is provided, the script validates translated keys, placeholder tokens, HTML-like fragments, newline counts, and likely untranslated values before delegating the merge to cirup while allowing missing keys for partial progress.
  • The import skill expects .translated.json to remain sparse. Untranslated keys should be omitted instead of copied in English unless you intentionally bypass that check with -AllowUnchangedValues.

© 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 2 other files (scripts) in .agents/skills/translation-diff-import of Devolutions/UniGetUI.

  • SKILL.md
  • scripts/import-translation-diff.ps1
  • scripts/validate-language-file.ps1

Open the folder on GitHubat commit ce0589d

Compare with similar skills

Translation Diff Import 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 Import compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Translation Diff Import this skillDevolutions/UniGetUI26k—~750Automated safety check: PassMIT
Plane UI Translationmakeplane/plane61k—~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.

    61k GitHub stars~16k tokensUpdated today
    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 8 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 today
    Auto-check passed
  • Translation Diff Translate

    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.

    26k GitHub stars~934 tokensUpdated today
    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 today
    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 today
    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 today
    Auto-check passed

Works with

Questions about Translation Diff Import

What does Translation Diff Import do?

Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result. Translation Diff Import is an agent skill from Devolutions/UniGetUI. Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result.

When should I use Translation Diff Import?

Translation Diff Import fits situations like: the user asks to apply; import a translation patch.

How do I install Translation Diff Import in Claude Code?

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

How do I install Translation Diff Import in Codex?

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

Can I use Translation Diff Import 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-import -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-import, .gemini/skills/translation-diff-import, .github/skills/translation-diff-import and .opencode/skills/translation-diff-import in your project.

What does Translation Diff Import need to run?

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

Does Translation Diff Import 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 Import 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 Import use?

Translation Diff Import 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 Import use?

About 750 tokens (SKILL.md is roughly 3k 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 Import?

Skills that share tags, products or a category with Translation Diff Import: Plane UI Translation (makeplane/plane, 61k 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 Import?

Devolutions (a GitHub organization) maintains it in Devolutions/UniGetUI, which has 26,418 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 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.