К основному содержанию
скилл CX Codex

oma-translation — скилл для Claude Code: что делает и как установить

Скилл oma-translation для Claude Code и Codex переводит и вычитывает интерфейсные строки, документацию и статьи с защитой плейсхолдеров. Синхронизирует файлы локализации после правок оригинала.

MIT ★ 1 472 обновлён 2026-11-12

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma-research@oh-my-agent
Открыть на GitHub

Что делает oma-translation

Скилл переводит интерфейсные строки, сообщения об ошибках, документацию и маркетинговые тексты. Главная задача при обработке файлов проекта — сохранить без изменений плейсхолдеры, фрагменты кода, адреса ссылок, ключи локалей и разметку списков.

Языковые профили подготовлены для корейского, японского, китайского и английского языков в папке resources/lang/. Если профиля для нужного языка нет, скилл переходит на общие правила адаптации. Тональность настраивается через параметр translation_voice в файле .agents/oma-config.yaml, где по умолчанию задан режим balanced.

Извлечением ключей из компонентов и настройкой библиотек интернационализации скилл не занимается. Для задач с плюрализацией или системными API дат требуются обычные инструменты разработки.

Какие задачи решает

  • перевести UI-строки и файлы локализации без поломки плейсхолдеров
  • синхронизировать переведённые файлы после правок в исходном тексте
  • проверить готовый перевод интерфейса на естественность и точность терминов
  • составить проектный глоссарий и руководство по стилю

Примеры запросов агенту

  • Переведи новые строки в locales/en.json на корейский язык, сохранив все плейсхолдеры.
  • Проверь японский перевод в docs/api.md на согласованность терминов.
  • Синхронизируй файл messages/de.po с последними изменениями в messages/en.po.

Как установить oma-translation

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma-research@oh-my-agent

Команда ставит плагин oma-research целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-translation -a claude-code

3Вручную: положить файлы

~/.claude/skills/oma-translation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/oma-translation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об oma-translation

Как установить oma-translation в Claude Code?

Выполните команду npx skills add first-fluke/oh-my-agent --skill oma-translation -a claude-code в терминале.

Что делает oma-translation?

Скилл переводит и редактирует тексты интерфейса, документацию и статьи. Он сопоставляет формулировки с глоссарием проекта и защищает переменные, пути к файлам и ссылки.

Умеет ли скилл извлекать ключи перевода из кода?

Нет, он работает только с текстом и готовыми файлами локалей. Настройку библиотек i18n, выгрузку ключей из шаблонов и логику плюрализации выполняют через инструменты разработки.

Исходный текст

SKILL.md · MIT
---
name: oma-translation
description: Translate or revise localized UI strings and prose while preserving
  meaning, terminology, placeholders, and structure.
---

# Translation - Context-Aware Localization

## Scheduling

### Goal
Translate, review, or adapt multilingual content faithfully and naturally while preserving the
parts that must remain exact: placeholders, code, links, formatting, terminology, and file
structure.

### Intent signature
- Translate, localize, review a translation, adapt copy, or create a glossary/style guide.
- Update target-language files after the source changed.

### When to use
- UI strings, error messages, locale files, documentation, reports, marketing copy, and prose.
- Review of existing translations for accuracy, register, terminology, or naturalness.

### When NOT to use
- i18n infrastructure, locale registration, or key extraction -> use the relevant development skill.
- Date/pluralization APIs or other code-level localization -> use the owning code-domain skill.

### Expected inputs
- Source text, target language or locale, content type, and requested output mode.
- Existing locale files, glossary, surrounding context, and optional author sample.
- Placeholder and formatting constraints when the source is structured.

### Expected outputs
- Natural target-language text or evidence-backed review findings.
- Exact preservation of placeholders, code spans, links, headings, list structure, and locale keys.
- Translator notes only for meaningful ambiguity or necessary cultural explanation.

### Dependencies
- Target profile: `resources/lang/{code}.md`, if one exists.
- `resources/translation-rubric.md` for substantive content or review.
- Selected external prose-style skills for English and Korean; loading and execution
  are defined in `resources/style-skills.md`.
- Shared prose diagnostics and translation exceptions for other target languages.
- Existing siblings and glossary when translating into a project.

### Control-flow features
- Branches by UI batch versus prose, profile availability, locale variant, ambiguity, and review mode.
- Loads only the target profile and references required for the content type.
- Edits files only when the user asked for file changes.

## Structural Flow

### Entry
1. Identify source, target locale, content type, and whether this is translate, review, or diff-sync.
2. Preserve exact tokens first: placeholders, code, URLs, keys, and structural markers.
3. Load the target profile if available; read sibling translations when the target is in a project.

### Scenes
1. **PREPARE**: Resolve locale, output mode, target audience, and protected syntax.
2. **ACQUIRE**: Read the target profile, relevant siblings, glossary, and source context. Select the substantive prose-style route in the canonical workflow; keep short independent UI strings on the lightweight path.
3. **REASON**: Determine meaning, register, terminology, cultural references, and any ambiguity. Decide whether an idiom should be interpreted, substituted, or retained.
4. **ACT**: Write natural target-language text. Match established project patterns without adding meaning, opinion, or personality.
5. **VERIFY**: Check protected syntax and structure. For substantive text, check meaning, terminology, register, and target-language naturalness against the rubric.
6. **FINALIZE**: Return the requested text, patch, or review with only supported findings.

### Transitions
- A profile exists -> load it; its target-language rules take precedence over shared guidance.
- A locale variant is required -> resolve it before drafting.
- No profile exists -> use shared guidance and note that limit once; do not borrow another language's rules.
- A short independent UI string with established siblings -> use protected-syntax and sibling checks; the full prose review is optional.
- Long prose, documentation, marketing copy, mixed tables/code, or review mode -> use the rubric.
- Ambiguous meaning that changes the result -> ask one targeted question or flag the choice.
- Diff-sync -> modify only source-touched equivalents, located by headings and surrounding context, not line number.

### Failure and recovery
| Failure | Recovery |
|---|---|
| Missing target context | Use the source register and state the assumption, unless the ambiguity changes meaning |
| Conflicting literal wording and project convention | Follow the established target convention and explain a material difference |
| Placeholder or structure mismatch | Revise before emitting or applying a patch |
| Missing profile | Use shared guidance and identify the coverage limit once |
| Unclear cultural reference | Add a concise note only when the target audience needs it |
| Selected external style skill unavailable | Complete supported translation checks and report the unavailable style pass; do not substitute another language's style skill or claim it ran |

### Exit
- Success: the text is faithful, natural, structurally safe, and checked in proportion to content risk.
- Partial: unresolved ambiguity, missing context, or an unavailable selected style pass
  is stated without inventing an answer or claiming that pass ran.

### Language profile loading

Resolve the BCP 47 primary subtag and load one matching profile when present:

| Target | Profile |
|---|---|
| Korean | `resources/lang/ko.md` |
| Japanese | `resources/lang/ja.md` |
| Chinese | `resources/lang/zh.md`; resolve the declared variant |
| English | `resources/lang/en.md` |
| Other | no profile; use shared guidance |

Profiles define typography, register, and target-language checks. Shared guidance explains common
risks. A profile wins if they conflict. Add a new profile from `resources/lang/_template.md` only
when the task is to extend this skill.

### Translation method

1. Read for meaning, intended effect, domain terms, and protected syntax. Identify figurative
   wording as **interpret**, **substitute**, or **retain**. Do not add a new metaphor or remove an
   intentional one without a reason.
2. Choose register from the source, target audience, and sibling translations. Apply
   `translation_voice` from `.agents/oma-config.yaml` only as a rhythm/formality preference:
   `formal`, `balanced` (default), or `interpreter`. It never overrides meaning or target norms.
3. Reconstruct in the target language. Change word order, split or merge sentences, and omit
   implied subjects only when the target language calls for it.
4. Preserve author style only where it belongs: prose, dialogue, adaptation, or explicitly
   user-authored documentation. Match observable rhythm and diction, never add facts, stance,
   jokes, first person, or stronger emotion.

### Verification

Always check:

- Every placeholder, code span, identifier, URL, and locale key is unchanged.
- Headings, links, table rows, list nesting, and code blocks retain their structure.
- The target follows its profile's typography and register rules.
- Existing siblings are matched when they establish terminology or UI style.

For substantive content and review mode, also check the rubric: meaning, naturalness,
terminology, register, cultural fit, and emotional force. Apply the selected target-language
style route while preserving intentional source style and content.

### Review mode

Review from evidence, not from an expectation that every draft is machine-translated. Record zero
findings when no material defect is confirmed. Separate:

- **Accuracy or safety defects**: changed meaning, broken placeholder, incorrect term, or wrong register.
- **Supported style findings**: a concrete target-language issue with a reason and proposed fix.
- **Preferences**: optional alternatives that do not make the existing translation wrong.

Do not rewrite a sound translation merely to produce findings.

### Batch and diff-sync work

For batches, read the complete set first, translate values only, and maintain one terminology and
register decision. Verify placeholders and key structure across the set.

For diff-sync, map each source hunk by heading and surrounding context. Touch only the affected
target section; leave unrelated text byte-identical. State updated sections, skipped cosmetic
hunks, and material terminology decisions.

### Output formats

For a single text, present the translation and brief notes for ambiguities or adaptations. For
files, preserve the input format and modify only requested values. For review, show the original,
the suggested revision only when warranted, and the evidence for each finding.

## Logical Operations

### Actions
| Action | SSL primitive | Evidence |
|---|---|---|
| Resolve locale and mode | `SELECT` | User request and file context |
| Read profile and siblings conditionally | `READ` | Target profile, glossary, nearby translations |
| Protect syntax and structure | `VALIDATE` | Source tokens and structural markers |
| Infer meaning and register | `INFER` | Source, audience, project convention |
| Translate or revise | `WRITE` | Target text or requested file patch |
| Review substantive content | `VALIDATE` | Rubric and concrete findings |
| Report result and limits | `NOTIFY` | Translation, patch, or review |

### Tools and instruments
- Native search/read for local source and sibling translations.
- Configured `code_intelligence` capability when available for code-context navigation; native
  search/read when it is unavailable or times out.
- Target profile, rubric, selected prose-style implementation, and language-template
  resources as selected by the canonical workflow.

### Canonical workflow path
1. Resolve target locale and protect exact syntax.
2. Load the one applicable language profile and relevant siblings; load the rubric for substantive
   content or review. For substantive prose, select by the **target** BCP 47 primary subtag:
   - `en` (including regional variants): load `resources/style-skills.md` and resolve `humanizer`.
   - `ko` (including regional variants): load that resource and resolve `humanize-korean`.
   - Other languages: load `../_shared/core/anti-ai-prose.md` with
     `resources/anti-ai-patterns.md` and the target profile.
   Short independent UI strings with established siblings need protected-syntax and
   sibling checks; they do not require an external prose-style pass.
   When a prose-style route is selected, record it with subject
   `translation.route-selection` per `../_shared/runtime/route-selection.md`
   (style skill, target subtag that selected it, and `translation_voice`).
3. Infer meaning, register, terminology, and figurative-language handling.
4. Draft in natural target order and project style.
5. Apply the selected style implementation to the draft, preserving review-only mode
   and translation fidelity. Then verify exact syntax, terminology, source claims,
   structure and diff-sync scope, and check substantive content against the rubric.
6. Emit the requested translation, patch, or evidence-backed review. State a missing-profile or
   context limitation when material.

### Resource scope
| Scope | Resource target |
|---|---|
| `LOCAL_FS` | Source/target files, glossaries, language profiles |
| `CODEBASE` | Sibling translations and code context |
| `PROCESS` | Syntax checks and selected external-skill acquisition or local gates |
| `NETWORK` | Upstream style-skill retrieval when not already available |
| `MEMORY` | Locale, terminology, register, protected syntax, unresolved ambiguity |

### Effects and side effects
- Produces translated text or review findings.
- Changes locale/docs files only when explicitly requested.
- Retains source structure, identifiers, and placeholders.
- May retrieve a missing selected style-skill bundle; reuses installed or cached
  instructions. Upstream intermediate files stay in a writable scratch workspace.

### Guardrails
1. Preserve meaning, protected syntax, and file structure before stylistic preference.
2. Do not invent facts, opinions, emotional emphasis, examples, citations, or personality.
3. Do not use a different language's profile as a substitute.
4. Do not change untouched sections during diff-sync.
5. Do not claim completion of a check that the available source cannot support.

## References

- Translation rubric: `resources/translation-rubric.md` (load for substantive content or review)
- Selected style skills: `resources/style-skills.md` (English or Korean substantive prose)
- Common prose diagnostics: `../_shared/core/anti-ai-prose.md` (other target languages, with translation exceptions when prose style needs review)
- Translation exceptions and grammar diagnostics: `resources/anti-ai-patterns.md` (other target languages, with common diagnostics when prose style needs review)
- Target profiles: `resources/lang/{ko,ja,zh,en}.md` (load one matching profile)
- Profile template: `resources/lang/_template.md` (only when adding a profile)
- Shared context loading: `../_shared/core/context-loading.md`
- Shared quality principles: `../_shared/core/quality-principles.md`

© First Fluke · MIT · first-fluke/oh-my-agent

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
blog-translate AgriciDaniel Скилл blog-translate переводит посты блога на один или несколько языков с локализацией метатегов, чисел, дат и валют. Сохраняет markdown, frontmatter, JSON-LD и встроенные графики. CX Codex +1 2 500установок Proxylang website translation Proxylang MCP-сервер Proxylang website translation подключает удалённый перевод веб-сайтов через один тег скрипта без создания учётной записи. Позволяет ассистенту настроить мультиязычность прямо в проекте. CX Codex +1 translation-expertise shino369 Скилл translation-expertise задаёт агенту методику перевода между английским, японским и традиционным китайским: идиомы, культурные нюансы, единый стиль документа. CX Codex +1 675установок blog-localize AgriciDaniel Скилл blog-localize для Claude Code. Адаптирует переведённую статью блога под целевой рынок: заменяет примеры брендов, статистику, законы и форму обращения на региональный стандарт. CX Codex +1 2 600установок enhanced-message-context lingui Скилл enhanced-message-context для Claude Code расставляет комментарии для переводчиков в сообщениях Lingui и решает, каким строкам они нужны — двусмысленным подписям и непрозрачным плейсхолдерам вроде {count}. CX Codex +1 630установок localization-engineer daffy0208 Скилл localization-engineer по интернационализации приложений на Next.js с библиотекой next-intl. Помогает настроить переводы, плюрализацию, форматирование дат и RTL-стили. CX Codex +1 163установок

Из того же набора69

Весь набор →
oma-design Скилл oma-design готовит и проверяет дизайн-систему проекта: от DESIGN.md до рекомендаций по доступности и адаптивной вёрстке. Пригодится до начала фронтенд-разработки или для аудита интерфейса. CX Codex +1 ★ 1 472звёзд репо oma-brainstorm Скилл oma-brainstorm для Claude Code и Codex помогает проработать идею фичи до планирования и написания кода. Задаёт уточняющие вопросы по одному, сравнивает варианты реализации и фиксирует решение в документации. CX Codex +1 ★ 1 472звёзд репо oma-orchestrator Скилл oma-orchestrator для Claude Code автоматизирует запуск нескольких специализированных агентов одновременно, координирует их через MCP Memory и отслеживает прогресс. CX Codex +1 ★ 1 472звёзд репо oma-explanation Скилл oma-explanation собирает диффы PR, веток или коммитов в самодостаточный HTML-разбор с фоном для новичков, разбором кода и квизом из пяти вопросов. CX Codex +1 ★ 1 472звёзд репо oma-scm Скилл oma-scm для Claude Code помогает безопасно выполнять операции с Git: коммитить, создавать ветки и разбирать конфликты. Включается по запросам о коммитах, релизах, worktree и управлении историей. CX Codex +1 ★ 1 472звёзд репо oma-db Скилл oma-db проектирует схемы баз данных, миграции и retrieval-архитектуру для векторного поиска. Разбирает нагрузку и ограничения перед тем, как предложить модель данных. CX Codex +1 ★ 1 472звёзд репо oma-slide Скилл oma-slide создаёт, импортирует и редактирует презентации, а затем собирает HTML-дек в PDF, PNG или PPTX. Запускается по запросу на слайды или работу с готовой презентацией. CX Codex +1 ★ 1 472звёзд репо oma-frontend Скилл oma-frontend для Claude Code помогает создавать и менять интерфейсы на React, Next.js или Angular. Разбирает компоненты, страницы, стили, формы и клиентское состояние. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой