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/translation-rubric.md
View on GitHub# Translation Quality Rubric
5 criteria, each scored on a 10-point scale. Total 50 points.
**This file is language-neutral.** Criterion 1 (Naturalness) and criterion 3
(Register) can only be scored against the target language's own conventions, so
score them with `lang/{code}.md` open. A draft that passes every red flag here
and fails its language profile's self-check is not a passing translation.
## Criteria
### 1. Naturalness (10 pts)
Does it read like it was originally written in the target language?
| Score | Description |
|-------|-------------|
| 9-10 | Native speaker cannot tell it's a translation |
| 7-8 | Reads naturally with minor awkwardness |
| 5-6 | Understandable but clearly "translated" |
| 3-4 | Awkward phrasing, unnatural word order |
| 1-2 | Word-for-word translation, painful to read |
Red flags:
- Source language word order leaking through
- Unnatural particles or prepositions
- Overly long sentences that should be split
- Pronouns handled against the target's pro-drop behavior
- Europeanized patterns: unnecessary connectives, passive voice abuse, noun pile-up, over-nominalization, cleft sentence calques
- Any rule in the target's language profile marked as a block-level failure
### 2. Accuracy (10 pts)
Is the meaning fully preserved?
| Score | Description |
|-------|-------------|
| 9-10 | Meaning, nuance, and intent fully preserved |
| 7-8 | Core meaning preserved, minor nuance loss |
| 5-6 | Main idea correct but some details lost |
| 3-4 | Partial meaning distortion |
| 1-2 | Meaning significantly changed or wrong |
Red flags:
- Added meaning not in source
- Omitted important qualifiers
- Reversed logic (negation errors)
- Hallucinated content
- Emotional connotations flattened (e.g., "alarming" rendered as a neutral "surprising" rather than something that carries concern)
- Figurative language translated literally when the image doesn't work in target language
### 3. Register Consistency (10 pts)
Does the tone match the configured register throughout?
The register system itself is language-specific (sentence endings, T-V
distinction, honorific paradigms, or none of these). Read the "Register" section
of `lang/{code}.md` before scoring this criterion.
| Score | Description |
|-------|-------------|
| 9-10 | Perfect register match, consistent throughout |
| 7-8 | Mostly consistent with rare slips |
| 5-6 | Noticeable register shifts |
| 3-4 | Inconsistent: mixes formal and casual |
| 1-2 | Wrong register entirely |
Red flags:
- Register drift between the opening and the closing of a document
- Mixing two register systems that the target treats as mutually exclusive
- Formal vocabulary in casual context or vice versa
- Honorific or politeness level that the source does not support
### 4. Terminology (10 pts)
Are domain terms consistent and correct?
| Score | Description |
|-------|-------------|
| 9-10 | All glossary terms applied, consistent throughout |
| 7-8 | Glossary followed with 1-2 misses |
| 5-6 | Some terms inconsistent across strings |
| 3-4 | Multiple glossary violations |
| 1-2 | Glossary ignored |
Red flags:
- Same source term translated differently in same batch
- Glossary term overridden without justification
- Technical term translated when it should stay in English
### 5. Technical Integrity (10 pts)
Are placeholders, formatting, and structure preserved?
| Score | Description |
|-------|-------------|
| 9-10 | All placeholders, tags, and structure intact |
| 7-8 | Intact with minor formatting differences |
| 5-6 | One placeholder or tag issue |
| 3-4 | Multiple broken placeholders |
| 1-2 | Structure significantly damaged |
Red flags:
- Modified or deleted `{variables}`
- Broken HTML/markdown tags
- Changed JSON/YAML key names
- Added or removed line breaks that affect rendering
## Scoring Guide
| Total | Grade | Action |
|-------|-------|--------|
| 45-50 | Excellent | Ship as-is |
| 38-44 | Good | Minor polish recommended |
| 30-37 | Acceptable | Review flagged items before shipping |
| 20-29 | Needs work | Re-translate problem sections |
| < 20 | Reject | Full re-translation required |
## Quick Self-Check (for translator)
Before submitting, verify:
- [ ] Read the full translation aloud: does it flow?
- [ ] Glossary terms are consistent across all strings
- [ ] Register matches config from start to finish
- [ ] All placeholders survived intact
- [ ] No source language word order leaking through
- [ ] Emotional connotations preserved (not flattened into neutral words)
- [ ] Figurative language handled naturally (interpret/substitute/retain, not literal calques)
- [ ] No Europeanized patterns (passive voice, noun pile-up, forced pronouns, unnecessary connectives)
- [ ] Translator's notes are concise, accurate, and calibrated to target audience
- [ ] The target language's own self-check in `lang/{code}.md` passed
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: 323k | 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 |