CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-translator

Context-aware translation that preserves tone, style, and natural word order. Use when translating UI strings, documentation, marketing copy, or any multilingual content. Infers register, domain, and style from the source text and surrounding codebase context.

62

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./benchmarks/runs/oma/.agents/skills/oma-translator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The core translation method is a strong, well-sequenced workflow with genuine validation checkpoints, but it is buried in a large body padded with ceremonial scaffolding sections that duplicate the method and explain knowledge Claude already has. Referenced resource files are clearly signaled yet missing from the bundle, with their content partially inlined instead. Trimming the Scheduling/Structural Flow/Logical Operations sections and actually shipping the referenced files would materially raise quality.

Suggestions

Remove or collapse the redundant scaffolding sections ('Scheduling', 'Structural Flow' with Scenes/Transitions, and 'Logical Operations' with the SSL-primitives table) — they restate the Translation Method stages and the description, cutting the body roughly in half without losing guidance.

Ship `resources/translation-rubric.md` and `resources/anti-ai-patterns.md` in the bundle (or inline them fully and drop the references) — the body currently points to files that are not present, and duplicates their key content inline anyway.

Drop or relocate time-sensitive claims ('Empirical evidence (Slator 2024, Self-Refine paper)') and universally known facts (SVO→SOV word-order basics), keeping only the operational rule ('reflection is default ON for non-trivial content').

DimensionReasoningScore

Conciseness

The ~430-line body contains several padded, redundant sections — 'Scheduling', 'Structural Flow' (Scenes PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE), and 'Logical Operations' (SSL primitives table) largely restate the Translation Method stages — and explains concepts Claude already knows (e.g., 'EN → KO: SVO → SOV, move verb to end'). It also cites time-sensitive sources ('Empirical evidence (Slator 2024, Self-Refine paper)') without a deprecation context. This matches the 'noticeably verbose; several unnecessary explanations or padded sections' anchor, not 3, because the duplication is structural rather than a few trimmable sentences.

2 / 5

Actionability

Concrete, executable guidance dominates: the mechanical checks ('search the draft output for `—`. Every occurrence must be replaced...'), persona/voice tables keyed to a real config field (`translation_voice` from `.agents/oma-config.yaml`), output format templates, a troubleshooting table, and a runnable `rg "<source-key-or-term>" .` command. It falls short of 5 because most instruction is procedural prose with only one actual command and no worked end-to-end example showing input → verified output.

4 / 5

Workflow Clarity

Stages 1–7 are explicitly sequenced with a mandatory, blocking 'Verification Gate' ('do not emit output until every item is confirmed'), explicit revise-and-rerun feedback loops ('If any mechanical check fails, revise and re-run'), and batch-specific validation ('batch size greater than 10 strings, verification is mandatory'). This matches the top anchor including error-recovery loops, and the batch-operation cap does not apply since validation is present.

5 / 5

Progressive Disclosure

References are one level deep and clearly listed ('Translation rubric: `resources/translation-rubric.md` — 5-criterion scoring...'), but the referenced files (`resources/translation-rubric.md`, `resources/anti-ai-patterns.md`, `../_shared/core/*`) do not exist in the bundle, and substantial content that belongs in those files (rubric questions, anti-AI pattern lists, translator's-note guidelines) is duplicated inline. This fits 'some structure but could be better organized; content that should be separate is inline' rather than 4, since the navigation promise cannot be fulfilled within the bundle as shipped.

3 / 5

Total

14

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is well-formed: third-person, explicit 'Use when...' triggers, and a clear statement of what the skill does and how it differs from mechanical translation. Its main gaps are mildly abstract capability wording and missing common synonyms like 'localize'/'l10n' in the trigger list. It scores at or near the top on completeness and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain and a couple of concrete behaviors — 'preserves tone, style, and natural word order' and 'Infers register, domain, and style' — but these are abstract capabilities rather than a list of specific actions, and coverage is incomplete (glossary creation, translation review, and batch i18n handling from the body are absent). This matches 'Names domain and 1-2 concrete actions, but not comprehensive' rather than 4, which requires several discrete specific actions.

3 / 5

Completeness

It explicitly answers both questions: what ('Context-aware translation that preserves tone, style, and natural word order... Infers register, domain, and style') and when, via a concrete 'Use when translating UI strings, documentation, marketing copy, or any multilingual content' clause with specific trigger phrases. Not 4 because the when-clause is fully explicit with concrete triggers rather than merely serviceable.

5 / 5

Trigger Term Quality

Trigger phrases 'UI strings, documentation, marketing copy, or any multilingual content' are natural terms a user would say, giving good keyword coverage. It falls short of the comprehensive anchor because common synonyms and variants are missing — 'localize', 'l10n', 'i18n files', and specific locale mentions users frequently use.

4 / 5

Distinctiveness Conflict Risk

Translation/localization is a clear niche with distinct triggers ('translating UI strings, marketing copy, multilingual content') and minimal conflict risk against typical neighboring skills (dev-workflow boundaries are even drawn in the body). The trailing 'or any multilingual content' slightly broadens scope but stays within the same niche, so it does not drop to 4.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
first-fluke/oh-my-agent
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.