xcstrings-localizer

A Claude Code plugin for localizing Apple .xcstrings (String Catalog) files with correct CLDR plural rules, domain-aware translations, and code-context comments.

Install

Claude Code (recommended)

# Add the marketplace
/plugin marketplace add nevinchanyi/claude-code-xcstrings-localizer

# Install the plugin
/plugin install xcstrings-localizer

Or install directly from the repo:

# Per-project
mkdir -p .claude/skills
cp -r skills/xcstrings-localizer .claude/skills/

# Global (all projects)
mkdir -p ~/.claude/skills
cp -r skills/xcstrings-localizer ~/.claude/skills/

Claude.ai (web/app)

1. Download xcstrings-localizer.skill from Releases
2. Go to Settings → Customize → Skills
3. Upload the .skill file and toggle it ON

Commands

#	Command	What it does
1	Scan Domain	Analyzes Swift types, enums, imports, README to build a glossary of ambiguous terms (e.g., "trip" = driving journey, not vacation)
2	Generate Comments	Scans Swift/Storyboard/XIB code to find string key usage, writes context + translator guidance into .xcstrings
3	Localize	Translates with correct CLDR plural forms per language, preserved %@/%lld specifiers, and domain-accurate terms
4	Check Grammar	Reviews translations for spelling, grammar, punctuation, capitalization and terminology consistency across all languages
5	Fix Plurals	Detects simple strings with %lld/%d that need plural forms and converts them to proper CLDR plural variations

Usage

You: Scan my project and localize Localizable.xcstrings to Ukrainian, German, and Japanese.

See USAGE_GUIDE.md for the full step-by-step walkthrough.

What's inside

.claude-plugin/
├── plugin.json                       — Plugin manifest for Claude Code
└── marketplace.json                  — Marketplace catalog (single plugin)
skills/
└── xcstrings-localizer/
    ├── SKILL.md                      — Skill instructions (5 commands)
    ├── scripts/
    │   ├── scan_project_domain.py    — Extracts types, enums, imports, README
    │   ├── scan_string_usage.py      — Finds string key usages with code context
    │   ├── extract_translation_values.py — Extracts translation values for grammar review
    │   └── detect_plural_candidates.py — Finds strings needing plural form conversion
    └── references/
        └── cldr-plural-rules.md      — Plural categories for 40+ languages

Key features

• CLDR plural rules for 40+ languages (Ukrainian=4 forms, Japanese=1, Arabic=6)
• Format specifier validation — verifies %@, %lld etc. in every translation
• Domain glossary — disambiguates terms like "trip", "route", "rate" using your actual codebase
• Code-aware comments — knows a key is used in a Button() vs .navigationTitle() vs .alert()
• Key vs value awareness — translates from the source value, not the key name
• Preserves existing work — flags suspicious translations as needs_review
• Grammar checking — reviews translations for spelling, grammar, punctuation, and terminology consistency
• Plural form detection — finds simple strings that should have plural variations and converts them automatically

Requirements

• Claude Pro, Max, Team, or Enterprise plan
• Claude Code 1.0+ (for plugin install) or Claude.ai with Code execution enabled

License

MIT