# migrate-i18next-to-lingui

Скилл migrate-i18next-to-lingui для Claude Code переносит проект с i18next и react-i18next на Lingui — от конфигурации до каталогов переводов. Помогает поэтапно заменить API.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 197 установок · ★ 12 у репозитория
- Автор: lingui
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/lingui/skills/tree/HEAD/skills/migrate-i18next-to-lingui/SKILL.md
- Обновлён: 2026-11-04
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/migrate-i18next-to-lingui

## Что делает

Скилл разбирает миграцию проекта с i18next и react-i18next на Lingui. Он охватывает установку пакетов, создание `lingui.config.js`, настройку Babel, SWC или Vite, замену инициализации, перенос React-компонентов и строк из JavaScript или TypeScript.

Отдельные шаги посвящены plural-формам, namespace, конвертации существующих каталогов и запуску `lingui extract` и `lingui compile`. В примерах показаны переходы от `useTranslation`, `i18n.t()` и `Trans i18nKey` к API Lingui. Для Lingui 6 нужен Node.js ≥ 22.19 или ≥ 24; на более старом Node.js пакеты `@lingui/*` нужно закрепить на `^5`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill migrate-i18next-to-lingui -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/migrate-i18next-to-lingui/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/migrate-i18next-to-lingui/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill migrate-i18next-to-lingui -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/migrate-i18next-to-lingui/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill migrate-i18next-to-lingui -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/migrate-i18next-to-lingui/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lingui/skills skills/migrate-i18next-to-lingui
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/migrate-i18next-to-lingui/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill migrate-i18next-to-lingui -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/lingui/skills --path skills/migrate-i18next-to-lingui
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/migrate-i18next-to-lingui/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill migrate-i18next-to-lingui -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/lingui/skills/tree/HEAD/skills/migrate-i18next-to-lingui/SKILL.md

## Когда брать
- перенести React-компоненты с `useTranslation` на `useLingui`
- заменить вызовы `i18n.t()` и `t()` на макросы Lingui
- перевести plural-ключи i18next в ICU MessageFormat
- настроить `lingui.config.js` и сборку через Vite, Babel или SWC
- конвертировать существующие JSON-каталоги переводов

## Примеры запросов агенту
- Перенеси этот проект с `i18next` и `react-i18next` на Lingui, сохранив ключи сообщений.
- Замени `useTranslation`, `Trans i18nKey` и вызовы `i18n.t()` в исходниках на эквиваленты Lingui.
- Настрой каталоги переводов, plural-формы и сборку для проекта на Vite.

## Похожие
- [i18next-localization](https://affpapa.org/nevibecode/skills/i18next-localization.md) — скилл · ★ 251 у репозитория
- [internationalization-i18n](https://affpapa.org/nevibecode/skills/aj-geddes-internationalization-i18n.md) — скилл · 648 установок
- [i18n-localization](https://affpapa.org/nevibecode/skills/i18n-localization.md) — скилл · 251 установка
- [add-localization](https://affpapa.org/nevibecode/skills/add-localization.md) — скилл · ★ 1167 у репозитория
- [migrate-radix-to-base](https://affpapa.org/nevibecode/skills/migrate-radix-to-base.md) — скилл · 37800 установок
- [i18n-expert](https://affpapa.org/nevibecode/skills/i18n-expert.md) — скилл · 2800 установок

Из того же набора: [lingui/skills](https://affpapa.org/nevibecode/by/lingui/skills.md) — 6 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
