How do I install the Add Translation skill?

Run npx skillmds@latest add tomevault-io/add-translation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Add Translation safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Add Translation?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Add Translation free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Add Translation?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Add Translation by tomevault-io — Agent Skill

Name: Add Translation
Author: tomevault-io

Add Translation

Add or update translation keys for i18n. Covers strings.json (primary source), en.json sync, and de.json German translations. Use when adding new log messages, UI strings, or updating existing translations. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Adding a Translation

IMPORTANT: aiohomematic/strings.json is the primary source for all translation keys. The file translations/en.json is automatically synchronized from strings.json.

Step 1: Use Translation in Code

from aiohomematic import i18n

# In code (for log messages)
_LOGGER.info(i18n.tr("log.my.message.key", param=value))

Step 2: Add to Translation Catalogs (in this order)

# Step 1: Add key to aiohomematic/strings.json (PRIMARY SOURCE)
{
  "log.my.message.key": "My message with {param}"
}

# Step 2: Run sync script to copy to en.json
python script/check_i18n_catalogs.py --fix

# Step 3: Add German translation to translations/de.json
{
  "log.my.message.key": "Meine Nachricht mit {param}"
}

Step 3: Validate Translations

python script/check_i18n.py aiohomematic/  # Check usage in code
python script/check_i18n_catalogs.py       # Check catalog sync

Key Files

File	Purpose
`aiohomematic/strings.json`	Primary source for all translation keys
`aiohomematic/translations/en.json`	Auto-synced from strings.json
`aiohomematic/translations/de.json`	German translations (manual)
`script/check_i18n.py`	Validate translation usage in code
`script/check_i18n_catalogs.py`	Check catalog sync between files

Source: SukramJ/aiohomematic — distributed by TomeVault.

---name: add-translationdescription: Add or update translation keys for i18n. Covers strings.json (primary source), en.json sync, and de.json German translations. Use when adding new log messages, UI strings, or updating existing translations. Use when this capability is needed.---# Adding a Translation**IMPORTANT**: `aiohomematic/strings.json` is the **primary source** for all translation keys. The file `translations/en.json` is automatically synchronized from `strings.json`.## Step 1: Use Translation in Code```pythonfrom aiohomematic import i18n# In code (for log messages)_LOGGER.info(i18n.tr("log.my.message.key", param=value))```## Step 2: Add to Translation Catalogs (in this order)```bash# Step 1: Add key to aiohomematic/strings.json (PRIMARY SOURCE){ "log.my.message.key": "My message with {param}"}# Step 2: Run sync script to copy to en.jsonpython script/check_i18n_catalogs.py --fix# Step 3: Add German translation to translations/de.json{ "log.my.message.key": "Meine Nachricht mit {param}"}```## Step 3: Validate Translations```bashpython script/check_i18n.py aiohomematic/ # Check usage in codepython script/check_i18n_catalogs.py # Check catalog sync```## Key Files| File | Purpose || ----------------------------------- | --------------------------------------- || `aiohomematic/strings.json` | Primary source for all translation keys || `aiohomematic/translations/en.json` | Auto-synced from strings.json || `aiohomematic/translations/de.json` | German translations (manual) || `script/check_i18n.py` | Validate translation usage in code || `script/check_i18n_catalogs.py` | Check catalog sync between files |---> Source: [SukramJ/aiohomematic](https://github.com/SukramJ/aiohomematic) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions