localization · johnrogers — скилл для Claude Code: что делает и как установить
Скилл localization ведёт агента по локализации iOS-приложения: String Catalogs, формы множественного числа, форматы дат и вёрстка справа налево.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/localization/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/localization/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill localization -a codex2Вручную: положить файлы
.agents/skills/localization/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill localization -a cursor2Вручную: положить файлы
.cursor/skills/localization/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/localization2Вручную: положить файлы
.github/skills/localization/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill localization -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/localizationВручную: положить файлы
.devin/skills/localization/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.