oliverv/caro / .agents/skills/oma-translation
oma-translation
VerifiedTranslate or revise localized UI strings and prose while preserving meaning, terminology, placeholders, and structure.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.2 KB |
| resources/anti-ai-patterns.md | markdown | 4.6 KB |
| resources/lang/_template.md | markdown | 3.0 KB |
| resources/lang/en.md | markdown | 8.2 KB |
| resources/lang/ja.md | markdown | 9.9 KB |
| resources/lang/ko.md | markdown | 15.1 KB |
| resources/lang/zh.md | markdown | 9.1 KB |
| resources/translation-rubric.md | markdown | 4.8 KB |
resources/lang/ja.md
View on GitHub# Japanese Target-Language Profile (`ja`)
Load this file whenever the **target** language is Japanese. It is read together
with `../translation-rubric.md` for substantive content or review. For prose style
review, also load `../../../_shared/core/anti-ai-prose.md` (common taxonomy) and
`../anti-ai-patterns.md` (translation exceptions and grammar diagnostics).
- **Localizations** of shared anti-AI patterns.
- **Japanese-only rules** (`JA-1`–`JA-9`).
---
## Register
| Style | Ending | Use for |
|---|---|---|
| です・ます体 (敬体) | `です` / `ます` | user-facing docs, READMEs, release notes, agent reports |
| だ・である体 (常体) | `だ` / `である` | specs, reference docs, academic prose, changelog bodies |
Resolution order:
1. Match the dominant style of sibling files in the same directory.
2. Otherwise map from `translation_voice`: `formal` → です・ます体 with fully
expanded sentences, `balanced` → です・ます体 for prose and である体 for
reference tables, `interpreter` → です・ます体 with shorter sentences and
permitted 体言止め in label positions.
Never mix the two inside one document. Headings and table cells are exempt.
**Honorifics**: use 尊敬語 / 謙譲語 only where the source addresses a person or the
project already does. Avoid 二重敬語 (`お伺いいたします` → `伺います`,
`ご覧になられる` → `ご覧になる`).
---
## Japanese-only rules
### JA-1. 一文一義 — one proposition per sentence
Japanese tolerates long sentences grammatically but reads poorly when a single
sentence carries three or more clauses joined by `〜が`, `〜ため`, `〜ので`. English
compound sentences should be split rather than chained.
```
Bad: この機能はキャッシュを使用しますが、初回実行時にはキャッシュがないため
レイテンシが増加しますので、事前にウォームアップを実行してください。
Good: この機能はキャッシュを使用します。初回実行時はキャッシュがないため
レイテンシが増加します。事前にウォームアップを実行してください。
```
### JA-2. Trim redundant potential and progressive forms
```
〜することができます → 〜できます
〜を行います → 〜します
〜という形になります → 〜です / 〜になります
〜させていただきます → 〜します (unless the source is genuinely deferential)
```
### JA-3. 体言止め is positional
Noun-ending sentences are natural in headings, bullet labels, and table cells,
and unnatural in narrative body text. This is the same boundary as Korean
`KO-3`, but Japanese tolerates 体言止め in more list positions.
```
Bad (body): `ANTHROPIC_API_KEY` の未設定。
Good (body): `ANTHROPIC_API_KEY` は設定されておらず、OAuth で認証します。
Good (cell): 結果: lint 失敗
```
### JA-4. Suffix abstraction overuse (`〜性` / `〜化` / `〜的`)
AI output stacks abstract suffixes where a verb or adjective is natural.
```
可用性の向上を実施します → より安定して使えるようにします
自動化を行います → 自動で処理します
構造的な問題 → 構造の問題
```
Keep the suffix when it is established terminology (`可用性`, `冪等性`,
`後方互換性` in technical specs).
### JA-5. Punctuation and script
- **句読点**: `、` and `。` (fullwidth). Never `,` `.` unless the project already
uses them.
- **Brackets**: `「」` for quotation, `『』` for titles and nested quotation,
fullwidth `()` for asides in Japanese text, halfwidth `()` around ASCII-only
content such as `(CLI)`.
- **Em dash**: `—` is not Japanese typography. Restructure, or use `。` to split.
Do not swap it for `:` and stop there (the mechanical punctuation swaps guidance).
- **中黒**: `・` for coordinating loanword nouns (`インストール・設定`).
- **Spacing**: follow the project convention for a space between Japanese and
ASCII runs. Read three sibling files before choosing; do not switch mid-file.
- **波ダッシュ**: `〜` for ranges (`3〜5 件`), not `~`.
### JA-6. 長音符 policy
`サーバー` vs `サーバ`, `コンピューター` vs `コンピュータ`. Both conventions are in
active use. Match the project's existing files; if none exist, use the JIS-style
long form (`サーバー`) for user-facing docs.
### JA-7. カタカナ vs 漢語
Do not romanize a concept the project already writes in 漢語, and do not force a
kanji compound where the loanword is the industry standard.
```
デプロイ keep (not 配備)
ロールバック keep (not 巻き戻し)
認証 keep (not オーセンティケーション)
検証 keep (not バリデーション) — unless the codebase uses バリデーション
```
Consistency with the project's existing translations decides.
### JA-8. Avoid 二重否定 and hedge stacking
```
Bad: 対応していないわけではありません
Good: 対応しています / 一部だけ対応しています
Bad: 可能性があるかもしれません
Good: 可能性があります
```
### JA-9. Numbers, dates, units
- Dates: `2026年8月20日` in prose, `2026-08-20` in tables and logs.
- Numerals: halfwidth (`5 件`, `12,000`), not `5件`.
- Percent: `40%` with no space.
- Counters must match the noun (`件`, `個`, `台`, `回`, `つ`).
---
## Localizations of shared rules
### `-ing` participle phrases
See [Superficial analysis](../../../_shared/core/anti-ai-prose.md#superficial-analysis).
```
EN: The update improves performance, ensuring a seamless experience
Bad: このアップデートはパフォーマンスを向上させ、シームレスな体験を保証します
Good: このアップデートでパフォーマンスが改善され、より快適に使えます
```
### AI vocabulary overuse
See [Vocabulary clustering](../../../_shared/core/anti-ai-prose.md#vocabulary-clustering).
| Watch | Prefer |
|---|---|
| また (sentence-initial, repeated) | restructure or drop |
| 重要な / 不可欠な | only when the source emphasizes |
| 活用する | 使う, 利用する |
| さまざまな | usually delete |
| 〜を通じて | restructure the clause |
| 最適化する / 最大化する | match the source's intensity |
### rule of three
See [Mechanical triples](../../../_shared/core/anti-ai-prose.md#mechanical-triples).
```
EN: a fast, reliable, and intuitive experience
Bad: 高速で、信頼性が高く、直感的な体験
Good: 速くて使いやすい
```
### synonym cycling
See [Synonym cycling](../../../_shared/core/anti-ai-prose.md#synonym-cycling).
If `ユーザー` is right, use `ユーザー` throughout. Do not rotate through
`利用者`, `使用者`, `エンドユーザー`.
### compound stacking
See [Compound adjective stacking](../../../_shared/core/anti-ai-prose.md#compound-adjective-stacking) and [Abstract noun and adjective stacking](../../../_shared/core/anti-ai-prose.md#abstract-noun-and-adjective-stacking).
```
Bad: AI 搭載のクラウドベースのエンタープライズグレードのソリューション
Good: クラウド上で動く AI ソリューション
```
### mechanical punctuation swap
See [Mechanical punctuation swaps](../../../_shared/core/anti-ai-prose.md#mechanical-punctuation-swaps).
```
Source: Documentation drift checks — broken refs and diff-affected docs
Lazy: ドキュメントドリフトチェック:壊れた参照と diff 影響ドキュメント
Better: 参照の整合性チェックと、変更の影響を受けるドキュメントの特定
```
### unnecessary connectives
See [Unnecessary Connectives](../anti-ai-patterns.md#unnecessary-connectives).
```
Bad: パフォーマンスが向上しました。したがって、ユーザー体験が良くなりました。
Good: パフォーマンスが向上し、ユーザー体験も良くなりました。
```
Watch したがって, しかしながら, さらに, また, その結果.
### passive voice
See [Passive Voice Abuse](../anti-ai-patterns.md#passive-voice-abuse).
```
Bad: この機能はチームによって開発されました
Good: チームがこの機能を開発しました
```
### noun pile-up
See [Noun Pile-up (Long Modifier Chains)](../anti-ai-patterns.md#noun-pile-up-long-modifier-chains).
```
Bad: AI ベースのクラウド対応リアルタイムデータ監視システム
Good: AI を使ってクラウド上でデータをリアルタイムに監視するシステム
```
### over-nominalization
See [Over-nominalization](../anti-ai-patterns.md#over-nominalization).
```
議論を行いました → 議論しました
改善を実施する → 改善する
検討を進める → 検討する
```
### forced pronouns
See [Awkward Pronoun Insertion](../anti-ai-patterns.md#awkward-pronoun-insertion).
```
Bad: 私たちはこの機能をリリースし、私たちは良い反応を得ました
Good: この機能をリリースしたところ、反応は良好でした
```
Japanese omits subjects freely. Insert `私たち` only when the actor genuinely
changes or contrast requires it.
### cleft calques
See [Cleft Sentence Calques](../anti-ai-patterns.md#cleft-sentence-calques).
```
Bad: 重要なのはユーザー体験であるということです
Good: ユーザー体験が最も重要です
```
---
## Japanese self-check
- [ ] One style throughout; no です・ます / である mixing
- [ ] No sentence chaining three or more clauses (`JA-1`)
- [ ] No `〜することができます` / `〜を行います` redundancy (`JA-2`)
- [ ] No 体言止め in narrative body text (`JA-3`)
- [ ] No stacked `〜性` / `〜化` / `〜的` where a verb works (`JA-4`)
- [ ] `、` `。` used; no `—`; no curly quotes (`JA-5`)
- [ ] 長音符 and カタカナ / 漢語 choices match sibling files (`JA-6`, `JA-7`)
- [ ] No 二重否定 or stacked hedges (`JA-8`)
- [ ] No 二重敬語
- [ ] Halfwidth numerals with correct counters (`JA-9`)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |