# using-bgs-translator

Скилл using-bgs-translator готовит перевод строк плагинов Bethesda (.esp, .esm, .esl): собирает LLM-батчи с глоссарием, ведёт проект и выгружает SST/XML для xTranslator.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1596 у репозитория
- Автор: awesome-bgs-mod-master contributors
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-translator/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/using-bgs-translator

## Что делает

Скилл ведёт перевод строк плагинов Bethesda: `.esp`, `.esm`, `.esl`. Он читает строки, собирает батчи для LLM с глоссарием и защитой служебных фрагментов, пишет базу проекта и выгружает словари SST/XML, которые доделывают в xTranslator или ESP-ESM Translator.

Файлы агент обрабатывает через `xtl`. Браузерный GUI нужен для ручной вычитки, ввода ключа провайдера и контроля прогресса; перезапуск — скриптом `scripts/restart-web-gui.ps1`. Перед массовым переводом скилл выясняет, какой плагин отдаёт строку в рантайме: базовую локализацию или старую версию мода может перекрыть более поздний патч.

Первым делом `xtl version`. CLI в комплект не входит, это пакет `bgs-translator` из PyPI, поэтому на чистой машине команда падает и скилл уходит в `setting-up-bgs-modding-environment` — там `pipx install bgs-translator==0.9.0rc1` и правка `PATH`. Нужны два пака знаний: игровой и локализационный, например `bgs-kb-starfield` и `bgs-l10n-starfield-zhhans`. Глоссарий из одной записи при живом паке — признак старого кэша в `%LOCALAPPDATA%/bgs-modding-superpowers/kb`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-translator -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-translator -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-translator -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hashgraph-online/awesome-codex-plugins plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-translator
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill using-bgs-translator -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/hashgraph-online/awesome-codex-plugins --path plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-translator
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/BB-84C/bgs-modding-superpowers/skills/using-bgs-translator/SKILL.md

## Когда брать
- перевести строки мода `.esp` на китайский через LLM-батчи
- собрать SST-словарь для xTranslator из плагина
- найти плагин, который отдаёт строку в рантайме
- удержать плейсхолдеры и FormID от перевода
- разобраться, почему глоссарий схлопнулся в одну запись

## Примеры запросов агенту
- Переведи `MyMod.esp` на упрощённый китайский, сначала покажи превью промпта.
- Собери SST для xTranslator из этого плагина.
- Какой плагин выигрывает эту строку в рантайме? Проверь до перевода.

## Похожие
- [oma-translator](https://affpapa.org/nevibecode/skills/oma-translator.md) — скилл · ★ 1472 у репозитория
- [translator-api](https://affpapa.org/nevibecode/skills/translator-api.md) — скилл · 513 установок
- [azure-translator](https://affpapa.org/nevibecode/skills/azure-translator.md) — скилл · 171 установка
- [Text Translator — 50+ Languages with Auto-Detection](https://affpapa.org/nevibecode/mcp/text-translator-50-languages-with-auto-detection.md) — MCP-сервер · 2463 установки
- [optimize-text-mesh-pro](https://affpapa.org/nevibecode/skills/optimize-text-mesh-pro.md) — скилл · 7200 установок
- [using-isometric-skills](https://affpapa.org/nevibecode/skills/using-isometric-skills.md) — скилл · ★ 51 у репозитория

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

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

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