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

localization · johnrogers — скилл для Claude Code: что делает и как установить

Скилл localization ведёт агента по локализации iOS-приложения: String Catalogs, формы множественного числа, форматы дат и вёрстка справа налево.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает localization

Скилл закрывает локализацию iOS-приложения на String Catalogs (.xcstrings): переводы строк, варианты множественного числа, форматы дат, чисел и валют, раскладка справа налево. Внутри четыре справочника — string-catalogs.md, pluralization.md, formatting.md, rtl-support.md. Агенту велено подгружать их, даже если тема лишь предположительно понадобится.

Порядок работы такой: создать каталог через File > New > String Catalog, разметить строки через String(localized:comment:) или отдать их SwiftUI на автоматическое извлечение, добавить варианты множественного числа, прогнать псевдолокализацию и выгрузить файлы на перевод. В настройках сборки включены «Use Compiler to Extract Swift Strings» и «Localization Prefers String Catalogs».

Сильнее всего бьёт забытая галочка Localize в File Inspector: без неё каталог не попадёт в Copy Bundle Resources, и приложение покажет исходные английские строки. Псевдолокализация тоже не формальность: на немецком и китайском вылезают обрезанные надписи, а на арабском ломается раскладка, если в коде остались жёсткие направления.

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

  • добавить в проект каталог строк .xcstrings
  • разметить строки через String(localized:) и оставить переводчику комментарий
  • собрать варианты множественного числа для русского
  • показать дату и цену в формате локали
  • поймать обрезанный текст до отправки на перевод

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

  • Добавь в проект String Catalog и перенеси туда все строки из SettingsView.swift.
  • Почему после сборки интерфейс остался на английском, хотя .xcstrings в проекте есть?
  • Прогони приложение с псевдолокализацией и покажи, где текст обрезается.

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

1Через маркетплейс плагинов

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

Команда ставит плагин swift-engineering целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill localization -a claude-code

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

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

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

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

Вопросы о localization

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

Через маркетплейс плагинов: сначала /plugin marketplace add johnrogers/claude-swift-engineering, потом /plugin install swift-engineering@claude-swift-engineering.

Что делает localization?

Помогает агенту размечать строки в String Catalogs, добавлять формы множественного числа и проверять вёрстку на языках справа налево. Отдельно перечислены типичные ошибки вроде каталога, не попавшего в Copy Bundle Resources.

Скилл помогает с языками справа налево?

Да, для этого есть справочник rtl-support.md про семантические направления. Проверять советует на арабском как системном языке.

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

SKILL.md · MIT
---
name: localization
description: Use when implementing internationalization (i18n), String Catalogs, pluralization, or right-to-left layout support. Covers modern localization workflows with Xcode String Catalogs and LocalizedStringKey patterns.
---

# Localization

Modern iOS localization using String Catalogs (.xcstrings) for managing translations, plural forms, and locale-aware content. Supports SwiftUI's LocalizedStringKey and String(localized:) APIs.

## Reference Loading Guide

**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.

| Reference | Load When |
|-----------|-----------|
| **[String Catalogs](references/string-catalogs.md)** | Setting up or using Xcode 15+ String Catalogs |
| **[Pluralization](references/pluralization.md)** | Handling plural forms, stringsdict migration |
| **[Formatting](references/formatting.md)** | Date, number, currency locale-aware formatting |
| **[RTL Support](references/rtl-support.md)** | Right-to-left layouts, semantic directions |

## Core Workflow

1. Create String Catalog in Xcode (File > New > String Catalog)
2. Mark strings with `String(localized:comment:)` or use SwiftUI's automatic extraction
3. Add plural variants in String Catalog editor where needed
4. Test with pseudo-localization (Scheme > Run > Options > App Language)
5. Export for translation (File > Export Localizations)

## Key Patterns

```swift
// SwiftUI - automatic localization
Text("Welcome")
Button("Continue") { }

// Explicit localization with context
let title = String(localized: "Settings", comment: "Navigation title")

// Deferred localization for custom views
struct CardView: View {
    let title: LocalizedStringResource
    var body: some View { Text(title) }
}
```

## Build Settings

- **Use Compiler to Extract Swift Strings**: Yes
- **Localization Prefers String Catalogs**: Yes

## Common Mistakes

1. **Forgetting String Catalog in Build Phases** — Adding String Catalog but forgetting to check "Localize" in File Inspector means it's not embedded. Always verify in Build Phases > Copy Bundle Resources.

2. **Pseudo-localization not tested** — Not running your app with pseudo-localization (German/Chinese pseudo-locale) means you miss text overflow and RTL issues. Always test with pseudo-localization before translation.

3. **Hardcoded strings anywhere** — Even one hardcoded string outside the String Catalog breaks extraction and automation. Use `String(localized:)` everywhere or use `LocalizedStringResource` for deferred localization.

4. **Context loss in translations** — Providing no comment for translators means they guess context and get it wrong. Add comments explaining where the string appears and what it means.

5. **RTL layouts not tested** — Assuming LTR layout works for RTL languages (Arabic, Hebrew) fails miserably. Test with system language set to Arabic and verify semantic directions are used.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

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

Все скиллы по теме «Мобильная разработка» →

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

localization Unity-Technologies Скилл настраивает пакет Unity Localization в проекте. Он создаёт таблицы строк, подключает ассеты и связывает переводы с интерфейсом. CX Codex +1 6 200установок localization appeeky Скилл localization помогает локализовать карточку приложения в App Store для новых стран: выбрать рынки, адаптировать метаданные и спланировать запуск. CX Codex +1 3 600установок cmux-localization manaflow-ai Скилл cmux-localization для проверки и управления переводами пользовательских строк в интерфейсе. Запускает аудит каждый раз, когда вы меняете текст кнопок, меню, подсказок или сообщений об ошибках. CX Codex +1 5 000установок ios-localization dpearson2699 Скилл ios-localization помогает внедрить и проверить локализацию iOS и macOS: каталоги строк, формы множественного числа, форматы и RTL-интерфейс. CX Codex +1 4 600установок axiom-swiftui CharlesWiltgen Скилл axiom-swiftui для Claude Code, Codex, Cursor, Copilot и других агентов, который подключается при любой работе со SwiftUI: вьюхи, навигация, лейаут, анимации, жесты, отладка. Охватывает фичи iOS 26 и iPhone Duo. CX Codex +1 1 700установок swiftui-whats-new-27 superagents-lab Скилл swiftui-whats-new-27 для Claude Code описывает изменения SwiftUI в SDK 27. Помогает адаптировать проект к новым API и исправить сборку после перехода @State на макросы. CX Codex +1 822установок flutter-setup-localization flutter Скилл flutter-setup-localization автоматизирует инициализацию поддержки многоязычности в Flutter-проекте. Добавляет зависимости, включает генерацию кода и создаёт конфиг для работы с .arb-файлами. CX Codex +1 39 900установок swiftui-claude-skills podo Набор из 8 скиллов по SwiftUI для iOS 26, включая Liquid Glass, аудит интерфейса, SwiftData и Foundation Models. Пригодится при сборке и ревью кода под Xcode 26.3. CX Codex +1 207установок

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

Весь набор →
ios-hig Скилл ios-hig помогает проектировать интерфейсы iOS с учётом рекомендаций Apple по доступности, визуальному оформлению и взаимодействию. Пригодится при создании экранов и проверке уже готовых элементов. CX Codex +1 ★ 233звёзд репо swift-engineer Субагент swift-engineer для Claude Code пишет код на чистом Swift без TCA: модели, сервисы, сеть и хранение в SQLite. Реализует фичи по готовому плану. CX Codex ★ 233звёзд репо grdb Помогает проектировать прямые запросы к SQLite, миграции и реактивные подписки через GRDB.swift в приложениях для iOS и macOS. CX Codex +1 ★ 233звёзд репо swift-diagnostics Скилл swift-diagnostics помогает разбирать сбои навигации, сборки и памяти в проектах iOS и macOS. Он ведёт по диагностическим шагам до проверки исправления. CX Codex +1 ★ 233звёзд репо swiftui-advanced Скилл swiftui-advanced для Claude Code с правилами по сложным жестам, адаптивной вёрстке, выбору архитектуры и профилированию в SwiftUI. CX Codex +1 ★ 233звёзд репо haptics Помогает добавить тактильную отдачу для подтверждений, ошибок и действий пользователя в iOS-приложении. Работает с UIKit и Core Haptics. CX Codex +1 ★ 233звёзд репо storekit Скилл ведёт агента через реализацию покупок в приложении: конфиг .storekit, StoreManager, проверка транзакций и экраны на SwiftUI. CX Codex +1 ★ 233звёзд репо swift-code-reviewer Субагент swift-code-reviewer проверяет код на Swift и iOS на безопасность, строгую конкурентность, производительность и соответствие HIG перед тестированием. CX Codex ★ 233звёзд репо

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

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