Localize Uk

Translate to Ukrainian (uk) — High-Fidelity Skill

Scope & Variants

Ukrainian is a single standard target — Modern Standard Ukrainian (літературна українська мова). No regional split for product UI:

| Locale | Notes | |--------|-------| | uk / uk-UA | Standard Ukrainian (Ukraine). Default and only target. |

Critical context for this skill: Ukrainian is NOT Russian. Many AI translators conflate them because they share Cyrillic script and Slavic structure, but they are distinct languages with distinct vocabulary, distinct letters, and (especially since 2022) strong political/cultural reasons NOT to mix them. Avoiding Russianisms is a top-tier quality concern.

Ukrainian vs Russian — letter and vocabulary identity

Ukrainian uses 4 letters Russian doesn't:

| Ukrainian | Used for | Russian equivalent | |-----------|----------|---------------------| | і | /i/ sound (most common Ukrainian vowel) | и (different sound) | | ї | /ji/ sound | doesn't exist | | є | /je/ sound | е (different) | | ґ | /g/ hard sound (used in foreign words) | г |

Russian uses 4 letters Ukrainian doesn't: ы, э, ъ, ё. Any of these appearing in Ukrainian text means a Russian word leaked in.

Common Ukrainian vs Russian vocabulary (the surface markers a translation must NOT mix):

| English | ✓ Ukrainian | ✗ Russian (do NOT use in uk) | |---------|-------------|------------------------------| | currently / now | наразі / зараз | сейчас | | also | також | тоже | | own (adj.) | власний | собственный | | print (v.) | друкувати | печатать | | ok / fine | гаразд / добре | хорошо / ладно | | thank you | дякую | спасибо | | please | будь ласка | пожалуйста | | city | місто | город | | only | лише / тільки | только | | almost | майже | почти | | together | разом | вместе | | year | рік | год | | month | місяць | месяц | | Tuesday | вівторок | вторник | | Monday | понеділок | понедельник | | green | зелений | зелёный | | who | хто | кто | | what | що | что | | where | де | где | | when | коли | когда | | if | якщо | если | | because | тому що / адже | потому что | | user | користувач | пользователь | | computer | комп'ютер | компьютер (note: no apostrophe in Russian) | | settings | налаштування | настройки | | password | пароль | пароль (same) | | account | обліковий запис / акаунт | учётная запись | | file | файл | файл (same) | | folder | папка / тека | папка (same) | | email | електронна пошта / ел. пошта | электронная почта | | download (v.) | завантажити | загрузить / скачать | | save (v.) | зберегти | сохранить | | delete (v.) | видалити | удалить |

If a Ukrainian translation contains сейчас, тоже, пожалуйста, сохранить, удалить, пользователь, настройки, только, почти, вместе — IT'S WRONG. Fix to the Ukrainian equivalents.

---

Register Auto-Detection (Apply Before Translating)

Ukrainian has a strong T-V distinction (Ви/ти). Auto-detect from source:

| Source signal | Target register | |---------------|-----------------| | Casual / conversational / personal (Hey!, contractions, emoji, marketing voice, gaming, social) | Informal (ти) — ти lowercase, 2nd-person sg. verb endings (-еш/-иш: можеш, бачиш), familiar imperative (singular form: вибери, натисни, відкрий). | | Neutral product UI / docs / consumer software (DEFAULT) | Formal (Ви) — Ви capitalized for direct address, 2nd-person pl. verb endings (-ете/-іте: можете, бачите), polite imperative (-ть/-іть: виберіть, натисніть, відкрийте). Possessive Ваш/Ваша/Ваше also capitalized. | | Legal / banking / government / enterprise B2B | Formal (Ви) elevated — same Ви form but full constructions, no contractions, prefer reflexive impersonal (Виконується), use formal vocabulary (обліковий запис over акаунт; електронна пошта over імейл). |

Hard rule: never mix levels in one text. A string with Ви можете (formal verb) and твої налаштування (informal possessive) is broken.

Capitalization rule for Ви: Ви / Ваш / Ваша / Ваше / Ваші / Вам / Вас are capitalized in direct second-person address. Failing to capitalize is read as informal even if the verb forms are formal.

Default for software UI: Ви (formal) unless brand voice is explicitly youth/casual.

---

Critical Hard Rules (Severity ≥ 2.0 — Auto-Fail If Wrong)

1. Ukrainian identity — NOT Russian (severity 2.5)

Documented above. The single most important Ukrainian rule. Check for Russian letters (ы, э, ъ, ё) and Russian vocabulary in your translation. Replace with Ukrainian equivalents.

2. Word integrity — verb prefixes NEVER split (severity 3.0)

Ukrainian verbs with prefixes are single words. Splitting them is a critical error.

| ✗ Wrong (split) | ✓ Correct (joined) | |-----------------|---------------------| | по будувати | побудувати (to build) | | пере класти | перекласти (to translate) | | ви конати | виконати (to execute) | | на діслати | надіслати (to send) | | за вантажити | завантажити (to load/upload) | | від крити | відкрити (to open) | | при йняти | прийняти (to accept) | | роз почати | розпочати (to begin) |

Reflexive -ся / -сь is ATTACHED (different from West/South Slavic) — it's a suffix, NOT a separate word in Ukrainian.

• завантажується ✓ (loads) — not завантажує ся and not завантажуєся (missing letter).
• реєструватися ✓ / реєструватись ✓ (both forms acceptable in infinitive).

Negation не rule:

• не + verb → separate word: не забуду, не знаю, не натискайте.
• не + adjective/noun (forming a word) → prefix attached: невидимий, неуспіх, неможливо, неправда.

3. Apostrophe usage (severity 2.0)

Ukrainian uses an apostrophe (') after labials (б / п / в / м / ф) and р before iotated vowels (я / ю / є / ї). This is mandatory — missing apostrophes are wrong.

| ✗ Wrong | ✓ Correct | English | |---------|-----------|---------| | компютер | комп'ютер | computer | | обєкт | об'єкт | object | | субєкт | суб'єкт | subject | | пять | п'ять | five | | память | пам'ять | memory | | імя | ім'я | name | | сімя | сім'я | family | | Кєв | К'єв would be wrong; the actual word is Київ (Kyiv, no apostrophe needed because к isn't a labial) | Kyiv | | розязати | розв'язати | to solve |

The Unicode apostrophe ' (U+2019, RIGHT SINGLE QUOTATION MARK) is preferred over the ASCII ' (U+0027) in published text, but ASCII ' is acceptable in UI strings where typography is not curated.

4. Seven-case system (severity 2.5)

Ukrainian uses all 7 Slavic cases, including an active vocative (used much more than in Russian). Every noun, adjective, and pronoun declines.

| Case | Question | Use | Example (m. sg. "користувач" — user) | Example (f. sg. "система" — system) | |------|----------|-----|--------------------------------------|---------------------------------------| | Називний (NOM) | хто? що? | Subject | користувач | система | | Родовий (GEN) | кого? чого? | Possession, "of", absence, 5+ count | користувача | системи | | Давальний (DAT) | кому? чому? | Indirect object, "to" | користувачу / користувачеві | системі | | Знахідний (ACC) | кого? що? | Direct object | користувача (animate=GEN) / файл (inanimate=NOM) | систему | | Орудний (INS) | ким? чим? | "With", means | користувачем | системою | | Місцевий (LOC) | на/у кому? чому? | Location (always w/ prep) | користувачі (на користувачеві) | системі (у системі) | | Кличний (VOC) | — | Direct address — ACTIVE in Ukrainian | користувачу! | системо! |

Critical: animate masculine accusative = genitive form. бачу користувача, NOT бачу користувач.

Vocative usage is REQUIRED for direct address (unlike Russian where it's archaic). When a Ukrainian product UI greets the user by name or addresses a role, use vocative:

| ✗ Russian-style (nominative for address) | ✓ Ukrainian (vocative) | |------------------------------------------|------------------------| | Привіт, Олександр! | Привіт, Олександре! | | Шановний користувач! | Шановний користувачу! | | Дякуємо, Марія! | Дякуємо, Маріє! |

5. Preposition + governed case (severity 2.5)

| Preposition | Case | Example | |-------------|------|---------| | у / в (in/into) | LOC (location) / ACC (motion) | у системі / у систему | | на (on/onto) | LOC / ACC | на сервері / на сервер | | з / зі / із (with/from) | INS ("with") / GEN ("from") | з користувачем / з папки | | без (without) | GEN | без помилок | | для (for) | GEN | для користувача | | від (from) | GEN | від користувача | | до (until/to) | GEN | до кінця | | про (about) | ACC | про користувача | | по (per / along) | LOC / DAT (with rate) | на день | | перед (before) | INS | перед збереженням | | після (after) | GEN | після входу | | за (per / behind) | INS / ACC | за день |

"per" in Ukrainian: use preposition + case, NOT the calque пер.

• per day → на день / щодня
• per file → за файл / на файл
• per user → на користувача / за користувача

6. Verb-governed case (severity 2.0)

Specific verbs require specific cases. Wrong case = critical error.

| Verb | Governs | Example | |------|---------|---------| | допомагати (help) | dative | допомагати користувачу (NOT користувача) | | дякувати (thank) | dative | дякую Вам | | керувати (manage/control) | instrumental | керувати системою (NOT систему) | | користуватися (use) | instrumental | користуватися сервісом | | володіти (own) | instrumental | володіти знаннями | | досягти (achieve) | genitive | досягти результату (NOT результат) | | уникнути (avoid) | genitive | уникнути помилки | | потребувати (need) | genitive | потребувати допомоги | | зустрічатися (meet) | INS with з- | зустрічатися з користувачем |

7. Relative pronoun agreement (який / яка / яке / які) (severity 2.5)

The relative pronoun MUST agree with its antecedent in gender and number:

| Antecedent | Pronoun | |------------|---------| | Masc. sg. (додаток) | який | | Fem. sg. (система) | яка | | Neut. sg. (налаштування) | яке | | Pl. (файли) | які |

| ✗ Wrong | ✓ Correct | |---------|-----------| | система, який працює | система, яка працює | | додаток, яка запущений | додаток, який запущений | | файли, яке завантажені | файли, які завантажені |

8. ICU plurals — one / few / many / other (1 / 2-4 / 5-20+ pattern) (severity 2.5)

{count, plural,
  one {# файл}
  few {# файли}
  many {# файлів}
  other {# файла}
}

CLDR plural category boundaries:

| Category | Rule | Examples | Noun form | |----------|------|----------|-----------| | one | n % 10 = 1, n % 100 ≠ 11 | 1, 21, 31, 41, 101, 121 | NOM singular (файл) | | few | n % 10 ∈ {2,3,4}, n % 100 ∉ {12,13,14} | 2, 3, 4, 22, 23, 24, 102, 103 | NOM plural (файли) | | many | n % 10 = 0 OR n % 10 ∈ {5-9} OR n % 100 ∈ {11-14} | 0, 5-20, 25-30, 100, 1000 | GEN plural (файлів) | | other | fractions | 1.5, 2.5 | GEN singular (файла) |

Critical: 11/12/13/14 use many (exceptions to the otherwise simple "ends in 1/2-4" pattern). Same pattern as Russian.

9. Numeral-noun agreement (severity 2.0)

The plural-form rule manifests directly in numeral constructions:

| Count | Pattern | Example | |-------|---------|---------| | 1 | NOM sg | 1 файл, 1 користувач | | 2, 3, 4 | NOM pl (NOT GEN sg like Croatian/Russian-Slavic-style!) | 2 файли, 3 користувачі | | 5+ | GEN pl | 5 файлів, 10 користувачів | | 11-14 | GEN pl (exception) | 11 файлів, 12 систем | | 21 | NOM sg (back to "one") | 21 файл | | 22-24 | NOM pl | 22 файли | | 25+ | GEN pl | 25 файлів |

Note vs other Slavic languages: Ukrainian uses nominative plural for 2-4 (like Russian), NOT genitive singular (which is Croatian/Bosnian). Don't apply Croatian/Serbian patterns here.

10. Three-gender adjective agreement (severity 2.0)

| Gender | Indef. example | Adjective ending (sg.) | |--------|---------------|------------------------| | Masculine (consonant ending) | користувач, файл | новий користувач, новий файл | | Feminine (-а/-я ending) | система, інформація | нова система, нова інформація | | Neuter (-о/-е ending) | налаштування, вікно | нове налаштування, нове вікно |

Wrong gender adjective is auto-fail: нова файл ✗, новий система ✗, нова налаштування ✗.

11. Past-tense gender agreement (severity 1.5)

Past tense in Ukrainian is the AUX-less L-participle (the AUX бути is dropped in present-day Ukrainian past), which agrees with subject in gender + number:

| Subject | L-participle | Example | |---------|--------------|---------| | m. sg. | -в | він працював | | f. sg. | -ла | вона працювала | | n. sg. | -ло | воно працювало | | pl. | -ли | вони працювали |

вона працював ✗ → вона працювала ✓.

12. Verb-construction integrity — no stacked finite verbs (severity 2.0)

English -ing (gerund as adverbial: "I spent 6 years building...") MUST be rendered with dieprislivnyk (дієприслівник, verbal adverb in -чи / -ючи / -ачи), NOT a second finite clause.

| ✗ Stacked finite | ✓ Verbal adverb (-чи) | English | |------------------|------------------------|---------| | Провів 6 років будував бізнес | Провів 6 років будуючи бізнес | I spent 6 years building the business | | Працював поки писав звіт | Працював пишучи звіт | I worked while writing the report | | Вона провела час чекала результати | Вона провела час чекаючи результати | She spent time waiting for results |

Common -чи forms (imperfective verbs only):

| Infinitive | -чи form | English | |------------|----------|---------| | чекати | чекаючи | waiting | | писати | пишучи | writing | | будувати | будуючи | building | | читати | читаючи | reading | | думати / розмірковувати | розмірковуючи | thinking | | використовувати | використовуючи | using | | приходити | приходячи | coming | | працювати | працюючи | working | | говорити | говорячи | speaking | | перекладати | перекладаючи | translating |

13. Complex constructions — щоб and перед (severity 2.0)

• щоб (so that / in order to) requires infinitive or past tense, NOT present indicative:
• ✗ щоб ви зберігаєте → ✓ щоб зберегти / щоб ви зберегли
• перед (before) requires instrumental verbal noun, OR use перш ніж + infinitive:
• ✗ перед зберігаєте → ✓ перед збереженням / перш ніж зберегти

14. Ellipsis completion — explicit nouns after numbers (severity 1.5)

Ukrainian requires explicit nouns after numbers and quantifiers; bare "5 others" sounds incomplete.

| ✗ Bare | ✓ Explicit | |--------|-----------| | 4 інших | ще 4 елементи / 4 інші файли | | і 3 більше | і ще 3 файли / і 3 додаткові |

15. False-friend: збуджений has sexual connotation (severity 2.0)

The Ukrainian word збуджений literally means "excited" but in modern usage carries a strong sexual/arousal connotation. NEVER use it as the casual "I'm excited (looking forward)" translation.

| ✗ Wrong (awkward / sexual) | ✓ Correct | |----------------------------|-----------| | Я збуджений! | Я в захваті! / З нетерпінням чекаю! / Я радий/рада! | | Збуджуючий продукт | Захоплюючий продукт / Цікавий продукт | | Збуджена аудиторія | Захоплена аудиторія / Зацікавлена аудиторія |

16. Diacritics and special letters — preserve (severity 2.5)

Ukrainian uses і, ї, є, ґ, ʼ (apostrophe). Never strip them. Stripping the apostrophe in комп'ютер to компютер is a critical readability failure.

---

Pronouns and Possessives

Personal pronouns

| English | Ukrainian | Notes | |---------|-----------|-------| | I | я | | | you (sg. informal) | ти | | | you (sg./pl. formal — capitalize) | Ви | Always capitalized in direct address | | you (pl. informal) | ви | lowercase when truly plural informal | | he

…

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: i18n-agent
• Source: i18n-agent/i18nstack
• License: MIT
• Homepage: https://i18nagent.ai

Install and usage instructions live in the source repository linked above.