localization-setup

Guide iOS developers through app localization setup and validation with String Catalogs.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill localization-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: localization-setup
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/apple-dev/skills/localization-setup
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill localization-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide interactive, context-aware guidance to set up and maintain iOS app localization, reducing mistakes with String Catalogs, pluralization, and variable handling by mapping user needs to focused sections of a reference guide.

Core Features & Use Cases

  • Interactive mapping from user scenario (initial setup, adding languages, pluralization, validation) to the exact section of the localization reference.
  • Practical guidance for creating and organizing .xcstrings, using String(localized:) patterns, handling pluralization and language-specific rules, and validating translations via pseudolocalization and simulator testing.
  • Use case: onboard a new language to an existing app by generating the correct String Catalog structure, explaining comment/context usage, and providing verification steps to test truncation and RTL layouts.

Quick Start

Ask the assistant to "Set up Chinese localization for my iOS app, create the String Catalog, and show pluralization examples for a sample view."

Frequently Asked Questions about localization-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up iOS localization using String Catalogs in Xcode?

To set up iOS localization, create a String Catalog (.xcstrings) file in Xcode and use the guided workflow to map your user scenarios into structured localization entries. This interactive guidance helps you organize strings and apply the correct initialization patterns for your app.

What's the best way to handle pluralization in iOS String Catalogs?

Handling pluralization in iOS String Catalogs requires defining language-specific plural rules directly within your .xcstrings files. The guided workflow provides practical steps to configure these variations and validate variable handling to prevent common localization mistakes.

Do I need a Mac and Xcode to use .xcstrings for app localization?

Yes, configuring app localization with .xcstrings files strictly requires a macOS environment running Xcode. The interactive guidance operates by extracting targeted sections from a localized reference guide to walk you through the Xcode-specific setup process.

How do I add a new language to an existing iOS app localization?

Adding a new language to an existing iOS app involves generating the correct String Catalog structure for that locale and providing appropriate context comments. The guided steps explain how to onboard the language and provide verification steps to test layout truncation.

Can I test RTL layouts and localization truncation using an iOS simulator?

Yes, you can validate translations and test RTL layouts by running your localized app in the iOS simulator. The guided workflow includes verification scenarios for pseudolocalization and simulator testing to ensure your interface handles different language lengths correctly.