# i18n-localization

The i18n-localization Claude Code skill guides internationalization and localization work. It activates for translation setup, locale-specific formatting, and adapting an app for multiple regions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 143 installs · ★ 114 repo stars
- Author: travisjneuman
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/travisjneuman/.claude/tree/HEAD/skills/i18n-localization/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/travisjneuman-i18n-localization

## What it does

The skill covers how to prepare an app for different languages and locales. It explains moving interface copy into translation files and handling dates, numbers, currencies, plural forms, and text direction. For plural rules, it recommends using a library rather than writing custom logic.

Reference material is split by task, including date and time formats, RTL support, React and Node.js implementation, translation workflows, and testing. The skill comes into play when adding locales or changing translated text and regional formatting. React and Node.js guidance lives in separate files.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill i18n-localization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/i18n-localization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/i18n-localization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill i18n-localization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/i18n-localization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill i18n-localization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/i18n-localization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install travisjneuman/.claude skills/i18n-localization
```

2. **Manually: put the files in place**
- File: `.github/skills/i18n-localization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill i18n-localization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/travisjneuman/.claude --path skills/i18n-localization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/i18n-localization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill i18n-localization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/travisjneuman/.claude/tree/HEAD/skills/i18n-localization/SKILL.md

## When to use it
- move interface copy into translation files
- format dates, times, and currencies by locale
- handle locale-specific plural forms
- prepare an interface for RTL languages
- plan locale testing

## Example prompts
- Add multiple-language support to this app and move its interface text into translation files.
- Set up date and currency formatting for the target locales.
- Check how to support RTL text and handle plural forms.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e4e398d8fde54ccb.

BEGIN THIRD-PARTY FILE e4e398d8fde54ccb
````text
---
name: i18n-localization
description: Internationalization and localization for global applications. Use when adding multi-language support, handling regional formats, or preparing apps for global markets.
---

# Internationalization & Localization

Comprehensive guide for building globally-ready applications.

## Key Concepts

### Terminology

```
i18n (Internationalization):
- Engineering for multiple languages/regions
- Building the infrastructure
- Happens once, during development

L10n (Localization):
- Adapting for specific locale
- Translation, formatting, content
- Happens per locale, ongoing

Locale:
- Language + Region combination
- Format: language-REGION (e.g., en-US, pt-BR)
- Determines formatting rules
```

### What Needs Localization?

| Category      | Examples                     |
| ------------- | ---------------------------- |
| **Text**      | UI labels, messages, errors  |
| **Numbers**   | 1,234.56 vs 1.234,56         |
| **Dates**     | MM/DD/YYYY vs DD/MM/YYYY     |
| **Times**     | 12-hour vs 24-hour           |
| **Currency**  | $1,234.56 vs €1.234,56       |
| **Plurals**   | 1 item vs 2 items vs 5 items |
| **Direction** | LTR vs RTL                   |
| **Images**    | Cultural appropriateness     |
| **Colors**    | Cultural significance        |
| **Names**     | Order, formality             |

---

## Text & Messages

### Externalize All Strings

```typescript
// DON'T: Hardcoded strings
const message = "Welcome back, " + username;

// DO: Externalized, translatable
const message = t('welcome_back', { name: username });

// Translation file (en.json)
{
  "welcome_back": "Welcome back, {{name}}"
}

// Translation file (es.json)
{
  "welcome_back": "Bienvenido de nuevo, {{name}}"
}
```

### Message Format

```typescript
// ICU Message Format (recommended)
// Handles plurals, select, dates, numbers

// Simple
"greeting": "Hello, {name}!"

// Plural
"items_count": "{count, plural, =0 {No items} one {# item} other {# items}}"

// Select (gender, etc.)
"notification": "{gender, select, male {He} female {She} other {They}} liked your post"

// Nested
"cart": "{itemCount, plural,
  =0 {Your cart is empty}
  one {You have # item in your cart}
  other {You have # items in your cart}
}"
```

### Pluralization

```
Languages have different plural rules:

English: 1 (one), 2+ (other)
French:  0-1 (one), 2+ (other)
Russian: Complex rules for 1, 2-4, 5-20, 21, etc.
Arabic:  6 plural forms!
Chinese: No plural forms

Always use library pluralization, never DIY:
- react-intl / formatjs
- i18next
- Intl.PluralRules API
```

---

## Reference files

Detailed material is in separate files so this overview stays short. Read only the file whose topic matches the task; each one is self-contained. Paths are relative to the folder that holds this `SKILL.md` (in the full toolkit install, `~/.claude/skills/i18n-localization/`).

| Topic | File | Covers |
| --- | --- | --- |
````
END THIRD-PARTY FILE e4e398d8fde54ccb

The third-party file has ended. Everything between the e4e398d8fde54ccb tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2938 of 4186 bytes. © travisjneuman · MIT · https://github.com/travisjneuman/.claude/tree/HEAD/skills/i18n-localization/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
