Agent skill

Add UI Translation

by ArduPilot in ArduPilot/MethodicConfigurator

Add a new translation language to the application. An agent skill from ArduPilot/MethodicConfigurator.

GPL-3.0Auto-check passedWriting & Content

Install Add UI Translation

skills CLI
$ npx skills add ArduPilot/MethodicConfigurator --skill add-ui-translation -a claude-code

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

GitHub CLI
$ gh skill install ArduPilot/MethodicConfigurator add-ui-translation --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/ArduPilot/MethodicConfigurator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/add-ui-translation .claude/skills/add-ui-translation && 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
add-ui-translation
GitHub stars
166
Token cost
~1.8k tokens
SKILL.md length
708 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
GPL-3.0

At a glance

Add a new translation language to the application. An agent skill from ArduPilot/MethodicConfigurator.

  • Works in 10 steps: Set Up Your Local Code Repository → Create a New Language Directory → Create a New PO File → …
  • Adding support for a new locale/language code
  • SKILL.md covers Adding a translation and Update an existing translation
  • Calls python, git and python3

What it does

Add UI Translation is an agent skill from ArduPilot/MethodicConfigurator. Add a new translation language to the application. Use when adding support for a new locale/language code, creating .po files from the .pot template, registering language codes in internationalization.py, LANGUAGECHOICES, tasks.json, pyproject.toml classifiers, and the Windows installer.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Translation and Internationalization. The repository describes itself as: A clear ArduPilot configuration sequence. The licence is GPL-3.0.

When your agent uses it

  • Adding support for a new locale/language code
  • Creating .po files from the .pot template
  • Registering language codes in internationalization.py
  • LANGUAGECHOICES

Example prompts

  • “/add-ui-translation”

Requirements

  • Python 3

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Set Up Your Local Code Repository
  2. Create a New Language Directory
  3. Create a New PO File
  4. Bulk translate the strings (optional)
  5. Translate the Strings
  6. Compile the PO File
  7. Test the New Language
  8. Review and Refine
  9. Install Poedit and open the .po and pot files
  10. Update and improve each translation string

What it can do on your machine

Read from SKILL.md and the folder at commit 7a37431. 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

    Shell commands in SKILL.md call:

    • python
    • git
    • python3

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

  • Network

    Links to these hosts (documentation or services it may open):

    • poedit.net

    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

Add UI Translation loads about 1.8k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 708 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from ArduPilot/MethodicConfigurator at commit 7a37431, republished under its GPL-3.0 licence (© ArduPilot). 708 words, ~1,802 tokens.

Download SKILL.mdSave it as .claude/skills/add-ui-translation/SKILL.md (or your agent's skills folder).
name
add-ui-translation
description
Add a new translation language to the application. Use when adding support for a new locale/language code, creating .po files from the .pot template, registering language codes in internationalization.py, LANGUAGE_CHOICES, tasks.json, pyproject.toml classifiers, and the Windows installer.

Translate the user interface

Adding a translation

To add a new translation language to the Ardupilot Methodic Configurator, follow the steps below. This process involves creating a new language folder in the locale directory and generating the necessary translation files. You will use the create_pot_file.py script to extract the strings that need translation and create a .pot file, which serves as a template for the translation.

1. Set Up Your Local Code Repository

If not done already navigate to a directory where you want to checkout the git repository and execute:

cmd
git clone https://github.com/ArduPilot/MethodicConfigurator.git
cd MethodicConfigurator

On Windows do:

cmd
.\SetupDeveloperPC.bat
.\install_msgfmt.bat
.\install_wsl.bat

On Linux and macOS do:

bash
./SetupDeveloperPC.sh
2. Create a New Language Directory

Navigate to the locale directory inside your project:

bash
cd ardupilot_methodic_configurator/locale

Create a new folder for the language you want to add. The name of the folder should follow the standard language code format (e.g., de for German, fr for French).

bash
mkdir <language_code>

For example, to add support for German:

bash
mkdir de

Add the language to the end of the LANGUAGE_CHOICES array in the ardupilot_methodic_configurator/internationalization.py file.

For example, to add support for German:

python
LANGUAGE_CHOICES = ["en", "zh_CN", "pt", "de", "it", "ja"]

Add it also to the test on tests\test_internationalization.py file:

python
    def test_language_choices(self) -> None:
        expected_languages = ["en", "zh_CN", "pt", "de", "it", "ja"]
        assert expected_languages == LANGUAGE_CHOICES

and .vscode\tasks.json file:

json
            "description": "Select language code:",
            "options": ["all", "zh_CN", "pt", "de", "it", "ja"],

and add the language as Natural Language :: to the classifiers array in the ardupilot_methodic_configurator/pyproject.toml file.

3. Create a New PO File

Inside your newly created language directory, create a new .po file using the .pot template:

bash
cd de
mkdir LC_MESSAGES
cp ../ardupilot_methodic_configurator.pot LC_MESSAGES/ardupilot_methodic_configurator.po
4. Bulk translate the strings (optional)

You can bootstrap your translation using translation services that translate full files. To do so navigate to the project root and issue:

bash
cd ..\..\..
python extract_missing_translations.py --lang-code=de

It will store the result of the bulk translations into n missing_translations_de[_n].txt file(s).

Now translate that file(s), or feed it to on-line translation service. Put all missing translations into a single missing_translations_de.txt Once done, insert the translations into the .po file:

bash
python insert_missing_translations.py --lang-code=de
5. Translate the Strings

Open the ardupilot_methodic_configurator.po file in a text editor or a specialist translation tool (e.g., Poedit). You will see the extracted strings, which you can begin translating.

Each entry will look like this:

text
msgid "Original English String"
msgstr ""

Fill in the msgstr lines with your translations:

text
msgid "Original English String"
msgstr "Translated String"
6. Compile the PO File

Once you have completed your translations, you will need to compile the .po file into a binary .mo file. This can be done using the command:

On Windows:

bash
python create_mo_files.py

On Linux or macOS:

bash
python3 create_mo_files.py

Make sure you have msgfmt installed, which is part of the GNU gettext package. On Windows use the .\install_msgfmt.bat command.

7. Test the New Language

Add it to the [Languages] and [Icons] sections of the windows/ardupilot_methodic_configurator.iss file.

text
[Languages]
Name: "en"; MessagesFile: "compiler:Default.isl"
Name: "zh_CN"; MessagesFile: "compiler:Languages\ChineseSimplified.isl"
Name: "pt"; MessagesFile: "compiler:Languages\Portuguese.isl"
Name: "de"; MessagesFile: "compiler:Languages\German.isl"
...

With the new .mo file created, you should ensure the software correctly loads the new language. Update the software's configuration to set the desired language and run the application to test your translations.

Show full SKILL.md (269 more words)Show less
8. Review and Refine

Once the new language is running in the software, review the translations within the application for clarity and correctness. Make adjustments as needed in the .po file and recompile to an .mo file.

Following these steps should enable you to successfully add support for any new translation language within the Ardupilot Methodic Configurator.

Update an existing translation

There is a github action to automatically update the translations using AI. To manually update an existing translation do the following steps:

1. Install Poedit and open the .po and pot files

Install Poedit v3.5.2 or greater on your PC.

Open the existing .po file for your language. Either download the file from the locale directory in github.com or if you have a local git checkout of ardupilot_methodic_configurator/locale use it.

Image: Open .po file

Here is an example for the italian translation:

Image: Select .po file

Update the translation by importing the latest .pot file.

Image: Update translation from .pot file

Either download the file from the locale directory in github.com or if you have a local git checkout of ardupilot_methodic_configurator/locale use it.

Image: Select .pot file

Validate the translation

Image: Validate translation

2. Update and improve each translation string

Search the table for strings that have not been translated yet and translate them. Update and improve each translation string.

Save the result and either send the .po file to the team, or create a gitlab Pull request with the changes to the .po file. The github robot will automatically convert that .po file into a .mo file and create an ArduPilot methodic configurator installer that you can use to test the translations.

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

Files

Just SKILL.md in .github/skills/add-ui-translation of ArduPilot/MethodicConfigurator.

Open the folder on GitHubat commit 7a37431

Compare with similar skills

Add UI Translation 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.

Add UI Translation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add UI Translation this skillArduPilot/MethodicConfigurator166—~1.8kAutomated safety check: PassGPL-3.0
Translation Diff ExportDevolutions/UniGetUI26k—~1.1kAutomated safety check: PassMIT
Translation Diff ImportDevolutions/UniGetUI26k—~750Automated safety check: PassMIT
Translation Diff TranslateDevolutions/UniGetUI26k—~934Automated safety check: PassMIT
Plane UI Translationmakeplane/plane61k—~16kAutomated safety check: PassAGPL-3.0
Translatetagspaces/tagspaces5.3k—~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • 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
    Writing & ContentAuto-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 today
    Writing & ContentAuto-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
    Writing & ContentAuto-check passed
  • 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 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 4 days ago
    Writing & ContentAuto-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
    Writing & ContentAuto-check passed

More from ArduPilot/MethodicConfigurator

All 11 skills in this repo
  • Update Gui Translations

    ArduPilot/MethodicConfigurator

    Update existing GUI translations using AI assistance. An agent skill from ArduPilot/MethodicConfigurator.

    166 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Architecture Validation

    ArduPilot/MethodicConfigurator

    Validate and update ARCHITECTUREn.md files against actual source code implementation.

    166 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Codebase Analysis

    ArduPilot/MethodicConfigurator

    Analyze the codebase structure and count lines of code by category using cloc.

    166 GitHub stars~2.2k tokensUpdated today
    Auto-check: notes
  • Configuration Steps Reorder

    ArduPilot/MethodicConfigurator

    Add, delete, or re-order configuration steps in configurationsteps.json.

    166 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Pytest Testing

    ArduPilot/MethodicConfigurator

    Write high-quality BDD pytest tests for the ArduPilot Methodic Configurator.

    166 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Sitl Testing

    ArduPilot/MethodicConfigurator

    Set up and run SITL integration tests for backendflightcontroller.py.

    166 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Add UI Translation

What does Add UI Translation do?

Add a new translation language to the application. An agent skill from ArduPilot/MethodicConfigurator. Add UI Translation is an agent skill from ArduPilot/MethodicConfigurator. Add a new translation language to the application.

When should I use Add UI Translation?

Add UI Translation fits situations like: adding support for a new locale/language code; creating .po files from the .pot template; registering language codes in internationalization.py; LANGUAGECHOICES.

How do I install Add UI Translation in Claude Code?

Run `npx skills add ArduPilot/MethodicConfigurator --skill add-ui-translation -a claude-code`. Or copy the skill folder (.github/skills/add-ui-translation in ArduPilot/MethodicConfigurator) into .claude/skills/add-ui-translation in your project. Claude Code loads it when a task matches its description.

How do I install Add UI Translation in Codex?

Run `npx skills add ArduPilot/MethodicConfigurator --skill add-ui-translation -a codex`. Or copy the skill folder (.github/skills/add-ui-translation in ArduPilot/MethodicConfigurator) into .agents/skills/add-ui-translation in your project. Codex loads it when a task matches its description.

Can I use Add UI Translation 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 ArduPilot/MethodicConfigurator --skill add-ui-translation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-ui-translation, .gemini/skills/add-ui-translation, .github/skills/add-ui-translation and .opencode/skills/add-ui-translation in your project.

What does Add UI Translation need to run?

Going by SKILL.md and its folder, Add UI Translation needs the command-line tools its instructions call (python, git and python3). Our summary lists: Python 3.

Does Add UI Translation access the network?

SKILL.md names 1 domain. As links in the text: poedit.net. This is read from the text; nothing was executed.

Is Add UI Translation 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. Review the folder before installing.

What licence does Add UI Translation use?

Add UI Translation is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add UI Translation use?

About 1.8k tokens (SKILL.md is roughly 7.2k 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 Add UI Translation?

Skills that share tags, products or a category with Add UI Translation: Translation Diff Export (Devolutions/UniGetUI, 26k stars), Translation Diff Import (Devolutions/UniGetUI, 26k stars), Translation Diff Translate (Devolutions/UniGetUI, 26k stars) and Plane UI Translation (makeplane/plane, 61k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add UI Translation?

ArduPilot (a GitHub organization) maintains it in ArduPilot/MethodicConfigurator, which has 166 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 9, 2026.

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