К основному содержанию
скилл CX Codex

localization-engineer · oakoss — скилл для Claude Code: установка и обзор

Скилл localization-engineer для Claude Code внедряет паттерны интернационализации и локализации в веб-приложения. Помогает настроить ICU, плюрализацию CLDR, RTL-вёрстку и теги hreflang.

MIT 103 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill localization-engineer -a claude-code
Открыть на GitHub

Что делает localization-engineer

Скилл формирует архитектуру мультиязычных проектов без привязки к конкретному фреймворку. Он предлагает правила работы с форматом сообщений ICU, разметку RTL через логические свойства CSS вроде margin-inline-start и форматирование через нативный Intl. Внутри также разобраны стратегии определения локали по URL, куки или заголовку Accept-Language.

Для выбора стека скилл сопоставляет Paraglide JS и i18next: первый даёт строгую типизацию на этапе сборки и минимальный бандл для новых проектов, а второй подходит для постепенного внедрения благодаря зрелой экосистеме. Отдельный блок посвящён поисковой оптимизации через разметку hreflang с атрибутом x-default.

Какие задачи решает

  • настроить плюрализацию по правилам CLDR через ICU
  • перевести интерфейс на RTL с помощью логических свойств CSS
  • организовать выбор между библиотеками Paraglide JS и i18next
  • прописать теги hreflang для мультиязычного SEO

Примеры запросов агенту

  • Помоги перевести форму на ICU с учётом рода и plural-форм
  • Настрой определение локали по URL и заголовку Accept-Language
  • Покажи, как заменить физические отступы на CSS logical properties для RTL

Как установить localization-engineer

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill localization-engineer -a claude-code

2Вручную: положить файлы

~/.claude/skills/localization-engineer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/localization-engineer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о localization-engineer

Как установить localization-engineer в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill localization-engineer -a claude-code в терминале. Также можно разместить файл по пути ~/.claude/skills/localization-engineer/SKILL.md.

Что делает скилл localization-engineer?

Он предоставляет готовые шаблоны для интернационализации (i18n) и локализации (l10n), охватывая ICU-сообщения, RTL, форматирование дат через Intl и настройку hreflang.

Какую библиотеку локализации советует скилл?

Для новых проектов с акцентом на типобезопасность и размер сборки предлагается Paraglide JS, а для существующих кодовых баз с развитой экосистемой плагинов — i18next.

Исходный текст

SKILL.md · MIT
---
name: localization-engineer
description: |
  Framework-agnostic internationalization (i18n) and localization (l10n) patterns for multilingual applications. Covers ICU message format, pluralization rules (CLDR), RTL layout with CSS logical properties, locale negotiation and detection strategies, SEO hreflang tags, cookie/header-based locale resolution, and translation workflow management.

  Use when adding multi-language support, choosing an i18n library, implementing pluralization or gender-aware messages, formatting dates/numbers/currencies by locale, handling RTL layouts, setting up locale detection, configuring hreflang SEO tags, or managing translation workflows.
license: MIT
metadata:
  author: oakoss
  version: '2.0'
---

# Localization Engineer

## Overview

Provides framework-agnostic patterns for building multilingual applications, covering the full i18n pipeline from locale detection through translation rendering. Addresses universal concerns like ICU message formatting, CLDR plural rules, RTL support, and SEO.

**When to use:** Adding multi-language support, locale-aware formatting, RTL layouts, pluralization, translation management, locale negotiation, multilingual SEO.

**When NOT to use:** Single-language apps with no internationalization plans, content that never changes locale, purely server-rendered static sites with no dynamic content.

**Key decision:** Choose Paraglide for compile-time type safety and minimal bundles in new projects. Choose i18next for broad ecosystem support and incremental adoption in existing projects. See the Library Selection table below.

## Library Selection

| Criteria          | Paraglide JS                                            | i18next                                           |
| ----------------- | ------------------------------------------------------- | ------------------------------------------------- |
| Architecture      | Compile-time, tree-shakable functions                   | Runtime, plugin-based ecosystem                   |
| Type safety       | Full (generated typed message functions)                | Partial (requires manual type setup)              |
| Bundle size       | Minimal (only used messages shipped)                    | Larger runtime (~40 kB base + plugins)            |
| Pluralization     | Via message format plugins                              | Built-in with CLDR plural categories              |
| Framework support | SvelteKit, TanStack Start, React Router, Astro, vanilla | React, Vue, Svelte, Angular, Node, vanilla        |
| ICU support       | Via `inlang-icu-messageformat-1` plugin                 | Via `i18next-icu` plugin                          |
| Translation tools | Fink editor, Sherlock VS Code extension                 | Locize, i18next-parser, many integrations         |
| Locale strategies | Built-in (cookie, URL, header, custom)                  | Via `i18next-browser-languagedetector` plugin     |
| SSR support       | AsyncLocalStorage-based per-request                     | Separate i18next instance per request             |
| Learning curve    | Low (compiler generates simple functions)               | Medium (large API surface, many plugins)          |
| Namespace support | Flat message files per locale                           | Multi-namespace with lazy loading per route       |
| Message format    | Inlang format or ICU via plugin                         | i18next JSON v4 or ICU via plugin                 |
| Community size    | Growing (inlang ecosystem)                              | Large (established since 2015)                    |
| Best for          | New projects prioritizing bundle size and type safety   | Existing projects needing broad ecosystem support |

## Quick Reference

| Pattern             | Approach                                                 | Key Points                                               |
| ------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
| ICU pluralization   | `{count, plural, one {# item} other {# items}}`          | CLDR categories: zero, one, two, few, many, other        |
| ICU select (gender) | `{gender, select, male {He} female {She} other {They}}`  | Covers gender-aware and variant-based messages           |
| ICU selectordinal   | `{rank, selectordinal, one {#st} two {#nd} other {#th}}` | Ordinal suffixes vary by language                        |
| Number formatting   | `Intl.NumberFormat(locale, options)`                     | Currency, percent, unit formatting built into platform   |
| Date formatting     | `Intl.DateTimeFormat(locale, options)`                   | Avoid manual date string construction                    |
| Relative time       | `Intl.RelativeTimeFormat(locale, options)`               | "3 hours ago", "in 2 days" with locale-aware output      |
| List formatting     | `Intl.ListFormat(locale, { type: 'conjunction' })`       | "Alice, Bob, and Charlie" with locale-aware conjunctions |
| RTL layout          | CSS logical properties (`inline-start`, `inline-end`)    | Replace `left`/`right` with logical equivalents          |
| RTL detection       | `<html dir="rtl" lang="ar">`                             | Set `dir` attribute based on locale                      |
| Locale from URL     | `/en/about`, `/de/about`                                 | Most SEO-friendly, clear to users                        |
| Locale from cookie  | `locale=de` cookie                                       | Persists preference across sessions                      |
| Locale from header  | `Accept-Language: de-DE,de;q=0.9,en;q=0.8`               | Browser preference, use as fallback                      |
| Hreflang tags       | `<link rel="alternate" hreflang="de" href="...">`        | One per locale plus `x-default`                          |
| Namespace splitting | Group translations by feature or route                   | Reduces bundle size via lazy loading                     |
| Message extraction  | Automated tooling scans source for translation keys      | Prevents orphaned or missing translations                |
| Pseudolocalization  | Generate fake translations to test layout                | Catches truncation, overflow, hardcoded strings          |

## Common Mistakes

| Mistake                                           | Correct Pattern                                                             |
| ------------------------------------------------- | --------------------------------------------------------------------------- |
| Concatenating translated fragments into sentences | Use ICU message format with placeholders for proper grammar across locales  |
| Using `margin-left`/`padding-right` with RTL      | Use CSS logical properties (`margin-inline-start`, `padding-inline-end`)    |
| Hardcoding plural rules (`count === 1`)           | Use CLDR plural categories (some languages have zero, two, few, many forms) |
| Detecting locale only from IP geolocation         | Use `Accept-Language` header, then cookie, then geolocation as last resort  |
| Missing `x-default` in hreflang tags              | Always include `<link rel="alternate" hreflang="x-default">` for fallback   |
| One massive translation file per locale           | Split into namespaces by feature for lazy loading and maintainability       |
| Creating new i18next instance per component       | Create once at app initialization, share across components                  |
| Formatting dates with string concatenation        | Use `Intl.DateTimeFormat` for locale-aware date rendering                   |
| Storing locale in component state                 | Store in URL path or cookie for SSR compatibility and shareability          |
| Using different i18n keys in client and server    | Share translation files and key structure between client and server         |
| Assuming all languages expand equally             | Budget 30-40% extra space for German/Finnish translations vs English        |
| Embedding text in images                          | Use CSS/SVG text overlays so translations can be applied dynamically        |
| Using language codes without region variants      | Use `en-US` vs `en-GB` when formatting differences matter (dates, currency) |

## Delegation

- **Audit codebase for hardcoded strings**: Use `Explore` agent to scan components for untranslated user-facing text
- **Set up full i18n pipeline**: Use `Task` agent to configure locale detection, translation loading, and rendering
- **Plan localization architecture**: Use `Plan` agent to design namespace structure, locale strategy, and translation workflow
- **Review translation coverage**: Use `Task` agent to compare translation files and identify missing keys across locales
- **Code review for i18n compliance**: Delegate to `code-reviewer` agent

> If the `tanstack-start` skill is available, delegate server middleware and SSR locale patterns to it.
> If the `tanstack-router` skill is available, delegate URL-based locale routing patterns to it.
> If the `sveltekit` skill is available, delegate SvelteKit-specific routing and hooks patterns to it.
> If the `seo` skill is available, delegate advanced hreflang and sitemap patterns to it.

## References

- [Paraglide JS patterns](references/paraglide.md) -- compile-time i18n with typed message functions, SvelteKit/TanStack Start/React Router integration, locale strategies
- [i18next patterns](references/i18next.md) -- runtime i18n with plugin ecosystem, React/Vue/Svelte/vanilla integration, namespaces, language detection
- [ICU message format](references/icu-message-format.md) -- pluralization, select, number/date formatting, nested messages, RTL support, hreflang SEO

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — localization-engineer от других авторов.

localization-engineer daffy0208 Скилл localization-engineer по интернационализации приложений на Next.js с библиотекой next-intl. Помогает настроить переводы, плюрализацию, форматирование дат и RTL-стили. CX Codex +1 163установок localization-l10n Mindrally Скилл localization-l10n с правилами локализации веб- и мобильных приложений. Помогает настроить переводы, региональные форматы дат и чисел, а также адаптацию вёрстки под RTL. CX Codex +1 736установок localization-testing proffesor-for-testing Скилл localization-testing проверяет переводы, форматы по локали, RTL-интерфейс и поддержку Unicode. Пригодится перед запуском продукта на новых языках и после изменений UI. CX Codex +1 137установок internationalization rampstackco Скилл internationalization помогает спланировать мультиязычный сайт: выбрать структуру адресов, настроить теги hreflang, выстроить перевод и адаптировать интерфейс. CX Codex +1 302установок flutter-setup-localization flutter Скилл flutter-setup-localization автоматизирует инициализацию поддержки многоязычности в Flutter-проекте. Добавляет зависимости, включает генерацию кода и создаёт конфиг для работы с .arb-файлами. CX Codex +1 39 900установок internationalization-i18n aj-geddes Скилл internationalization-i18n для Claude Code помогает внедрять интернационализацию и локализацию в приложении. Он включается для работы с переводами, форматами и языками с письмом справа налево. CX Codex +1 648установок i18next-localization i18next Скилл i18next-localization настраивает локализацию приложения через i18next: находит жёстко заданные строки, оборачивает их в вызовы переводов и собирает файлы локалей. Locize можно подключить отдельно. CX Codex +1 ★ 251звёзд репо

Из того же набора106

Весь набор →
turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок realtime-sync Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок plan-first-development Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы. CX Codex +1 107установок tracer-bullets Скилл tracer-bullets для Claude Code разбивает многоуровневую разработку на вертикальные срезы. Каждый срез проверяется до начала следующего. CX Codex +1 107установок expert-instruction Скилл expert-instruction для Claude Code помогает проектировать системные инструкции для ИИ-агентов. Он включается при настройке роли агента, ограничений, формата ответов и работы с инструментами. CX Codex +1 106установок codebase-packager Скилл codebase-packager для Claude Code готовит контекст крупного репозитория для ИИ-кодинга. Он собирает дайджесты, упаковывает файлы и помогает проследить связи между ними. CX Codex +1 105установок skill-management Скилл skill-management для Claude Code помогает создавать, проверять и исправлять скиллы по стандарту Agent Skills. Он включается для аудита структуры, описаний и соответствия файлов манифесту. CX Codex +1 105установок meta-agent-creator Скилл meta-agent-creator для Claude Code помогает создавать субагентов и настраивать их параметры. Используйте его при проектировании делегирования задач и ограничении доступа к инструментам. CX Codex +1 104установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой