# Locale Tui Localization

> Use this skill when users request i18n/localization updates for Android string resources, especially when adding new keys or translating via locale-tui.

- Skill: `gabrielmoreira/locale-tui-localization` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/locale-tui-localization`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/locale-tui-localization/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/locale-tui-localization

---


# Locale TUI Localization

Use this skill for Android localization tasks that should be handled by `locale-tui`.

## When to use

- The user asks to add a new localized string key.
- The user asks to translate/update `strings.xml` across multiple locales.
- The user mentions i18n/l10n or `locale-tui`.

## Workflow

1. Confirm the target module (for example `app`).
2. Create/update strings with `locale-tui` instead of editing all locale files by hand.
3. Prefer auto-translation unless the user asks to skip it.
4. Verify generated changes in affected `values-*/strings.xml` files.
5. Report the exact files changed and what was added/updated.

## Commands

```bash
# Add a new string resource with automatic translation
uv run --directory locale-tui src/main.py add <key> "<English Value>" [OPTIONS]

# Examples
uv run --directory locale-tui src/main.py add hello_world "Hello, World!"
uv run --directory locale-tui src/main.py add greeting "Welcome" -m app
uv run --directory locale-tui src/main.py add test_key "Test" --skip-translate
```

## Options

- `--module, -m`: Specify module name (defaults to first module in config)
- `--skip-translate`: Add only to source language and skip translations

## Constraints

- Input value should be English.
- If user explicitly requests localization, ensure all configured languages are updated.
- Do not commit secrets or API keys.