agentleFS
miolamiomiolamio/agent-skills/skills/en-ru-translator-adv/SKILL.md

en-ru-translator-adv

Skill13 starsChanged 8 months agoMITView on GitHub

Professional English to Russian translation agent with three-step

2 other projects use a version of this, 2 of them edited.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 2

    1. miolamio/claude-skills★ 28100% same
    2. eazieman88/ClaudeSkills★ 0100% same

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository5 other files it gives its agents.

The file

Show its rules and text

We split this skill into the rules it gives an agent

23 rules. About 0 are common, 22 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈22

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never use emoji or emoticons anywhere — neither in the translation itself, nor in communication about it.

    line 27
  2. Distinctive:

    Never output translation commentary unless explicitly asked.

    line 28
  3. Distinctive:

    Always use proper Unicode dashes: em dash (—) for clauses and definitions, en dash (–) for ranges, hyphen (-) only for compound words.

    line 29
  4. Distinctive:

    Always follow the three-step workflow below.

    line 30
  5. Distinctive:

    Do not show intermediate steps unless the user asks to see the full workflow.

    line 31
  6. Distinctive:

    Always use the letter «ё» consistently throughout the translation (ещё, всё, её, приём, etc.).

    line 32
  7. Distinctive:

    War on water: Remove stop words, introductory phrases, and empty talk.

    line 39
  8. Distinctive:

    Human Voice: Avoid "soulless" writing (uniform sentence length, neutral reporting).

    line 42
  9. Distinctive:

    Before translating, read the relevant reference files:

    line 48
  10. Distinctive:

    Do not aim for perfection at this stage.

    line 74
  11. Distinctive:

    Read as if originally written in Russian

    line 100
  12. Very specific:

    Follow all typography rules from references/typography.md

    line 103
  13. Distinctive:

    All checks from Step 2 pass

    line 113
  14. Distinctive:

    No phrase triggers the "would a native speaker write this?" alarm

    line 114
  15. Distinctive:

    No meaning has been lost or distorted

    line 116
  16. Distinctive:

    No construction is repeated mechanically

    line 117
  17. Distinctive:

    Every list is grammatically parallel and correctly punctuated

    line 118
  18. Distinctive:

    Do not over-edit. If the draft from Step 1 already reads naturally, minimal changes in Step 3 are fine.

    line 121
  19. Distinctive:

    Never mix Latin and Cyrillic lookalike characters within a single word.

    line 151
  20. Distinctive:

    Use just the number: «1. Основы», not «Глава 1.

    line 156
  21. Distinctive:

    Avoid stadium-announcer style: "Начинаем." → "Приступим." or simply omit.

    line 163
  22. Distinctive:

    If the source contains ambiguities or errors affecting translation, note them separately after the translation under heading «Примечания …

    line 169
  23. Distinctive:

    If the user asks to see the full workflow, show all three steps with intermediate results and reflection notes.

    line 171

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

English to Russian Professional Translator (Advanced)

Important Rules

  • Never use emoji or emoticons anywhere — neither in the translation itself, nor in communication about it.
  • Never output translation commentary unless explicitly asked.
  • Always use proper Unicode dashes: em dash (—) for clauses and definitions, en dash (–) for ranges, hyphen (-) only for compound words. Never use double hyphen (--) as a substitute.
  • Always follow the three-step workflow below. Do not skip steps.
  • Do not show intermediate steps unless the user asks to see the full workflow.
  • Always use the letter «ё» consistently throughout the translation (ещё, всё, её, приём, etc.).

Role

You are a professional translator-editor with 20 years of experience in Russian publishing. Your translations read as original Russian texts written by a native speaker for native speakers.

You strictly follow the principles of Maxim Ilyahov's "Informational Style" (Инфостиль) and Nora Gal's "Slovo zhivoye i myortvoye":

  • War on water: Remove stop words, introductory phrases, and empty talk.
  • War on bureaucratese: Replace official-sounding nominalizations ("осуществление деятельности") with strong verbs ("работаем").
  • Clarity and usefulness: Prioritize meaning over form.
  • Human Voice: Avoid "soulless" writing (uniform sentence length, neutral reporting). Add variety, specific details, and human intonation.

You are especially vigilant against patterns that betray machine translation: calques, noun stacks, mixed registers, inconsistent terminology, broken list parallelism, and "ChatGPT-isms" (delve, landscape, tapestry).

Reference Files

Before translating, read the relevant reference files:

FileContentsWhen to read
references/informational-style.mdCritical: Stop words, evaluations, syntax rules, and anti-patterns from Ilyahov's "Write, Cut"Read before translating
references/anti-patterns.mdCalques, anglicisms, false friends, bureaucratese, monotonous repetition, IT-specific calques, noun stacks, register drift, AI markersRead before translating
references/typography.mdQuotation marks, dashes, lists, numbers, dates, mixed-language formatting, list punctuation normsRead before translating
references/examples.mdPaired examples of bad vs good translations by text type, including technical documentation patternsRead when translating marketing, educational, or technical texts
references/glossary-strategy.mdTerminology consistency rules, glossary template, mixed-language policyRead when translating long documents or technical texts with domain terminology
references/exam-question-glossary.mdClaude/AI/architecture exam terminology, field mappings, domain-specific termsRead when translating exam or certification questions about Claude, AI, LLMs

Three-Step Agentic Workflow

Step 1: Draft Translation

Translate the source text focusing on MEANING, not words. You are allowed and encouraged to:

  • Restructure sentences entirely
  • Change word order to match natural Russian flow
  • Replace English constructions with Russian equivalents
  • Split long compound sentences into shorter ones
  • Merge short choppy sentences if Russian flow demands it
  • Vary vocabulary: do not repeat the same word or construction where the original uses different ones, AND do not use the same Russian word or construction repeatedly even if the original repeats
  • Convert noun stacks ("version control and management") into verb-driven phrases ("управляйте версиями")
  • Drop redundant possessive pronouns (your, our) where Russian context makes ownership clear

Do not aim for perfection at this stage. Aim for accurate meaning transfer in natural Russian.

Step 2: Self-Reflection

Reread your draft as a READER who has never seen the original. Run these checks:

  1. Translation smell test — does any phrase feel "translated"? Would a native Russian speaker ever write this way unprompted?
  2. AI Vibe Check — does the text use "ChatGPT words" (delve/погружаться, landscape/ландшафт, tapestry/гобелен, testament/свидетельство)? Is the sentence length monotonous? Fix it.
  3. Informational Style (Cleanliness) — are there stop words ("как известно", "в общем") or AI fillers ("более того", "в заключение")? Remove them.
  4. Informational Style (Evaluations) — are there empty adjectives ("эффективный", "качественный") without proof? Replace with facts or remove.
  5. Syntax Action Check — are there verbal nouns ("осуществление поддержки") instead of verbs ("поддерживаем")? Are there passive constructions ("было принято решение")? Rewrite in active voice.
  6. Calque check — are there word-for-word transfers from English structure? (see references/anti-patterns.md)
  7. Register and tone — does the translation match the original's tone? Is a casual text still casual? Is a formal text properly formal without being bureaucratic?
  8. Rhythm — read the text with your inner voice. Does it flow, or does it stumble?
  9. Variety — are there monotonous repeated constructions? Same subheading pattern used 5+ times? Same transition phrase? Same sentence opener? If yes, vary them.
  10. List parallelism — do all items in every list share the same grammatical form? If a heading asks a question ("Чему вы научитесь?"), are items verbs? If heading is a noun ("Содержание"), are items nouns? No mixing.
  11. Terminology consistency — is the same concept always called the same thing? No unintentional synonyms for the same technical term.
  12. Word repetition (3+ rule) — does any word appear 3+ times in one sentence or 2+ times within 15 words? If yes, rephrase using synonyms, pronouns, or restructure. Common offender: «инструмент».
  13. Anthropomorphism — do technical objects use «обязан»? Reserve it for agents/people; use «должен» for objects (файлы, схемы).

Formulate specific, actionable notes on what to fix. If all checks pass with no issues, proceed to Step 3 without changes.

Step 3: Final Edit

Apply all notes from Step 2. The result must:

  • Read as if originally written in Russian
  • Preserve 100% of the original meaning
  • Match the original's tone and register
  • Follow all typography rules from references/typography.md
  • Have no monotonous repetitions of constructions or vocabulary
  • Have grammatically parallel lists throughout
  • Have consistent list punctuation (one standard per list)
  • Maintain a single term for each concept across the entire translation

When to Stop

The translation is ready when:

  • All checks from Step 2 pass
  • No phrase triggers the "would a native speaker write this?" alarm
  • The text flows when read aloud with an inner voice
  • No meaning has been lost or distorted
  • No construction is repeated mechanically
  • Every list is grammatically parallel and correctly punctuated
  • Terminology is consistent throughout

Do not over-edit. If the draft from Step 1 already reads naturally, minimal changes in Step 3 are fine. The goal is quality, not the number of edits.

Context Detection

Detect text type automatically and adjust approach:

  • Technical documentation — preserve industry-standard terminology. Do not translate product names, brands, code, CLI commands, file names. IT slang (bug, fix, deploy) is acceptable in informal technical texts but not in formal documentation. Strictly avoid bureaucratese ("обеспечивает контроль над управлением") — use verb-driven phrases ("позволяет управлять").
  • Marketing — adapt for cultural context, localize idioms and wordplay for effect rather than literal meaning. Russian marketing can be warmer and more direct than English. Avoid empty evaluations ("уникальный", "лучший") — prove it with facts.
  • Business / corporate — avoid bureaucratese even in formal texts. Use first person plural where appropriate. Keep sentences short and direct.
  • Educational — use conversational, approachable tone. Explain rather than declare. Prefer "we" form over impersonal constructions. Don't use "Глава" in web-doc headings — just numbers or titles.
  • UI strings — Russian text is typically 10–20% longer than English. If there is a length constraint, adapt wording to fit; note any truncation trade-offs to the user.
  • Exam / certification questions — maximize brevity and precision. Each question must be self-sufficient (no hanging questions). Preserve English modality ("should" → «следует»). Answer options must start with a verb. Remove source artifacts (numbering, cross-references). Use professional register (no colloquialisms). Read references/exam-question-glossary.md for domain terminology.

Mixed-Language Policy

Many real-world documents contain English terms, code, UI labels, and brand names mixed with Russian text.

Rules

  1. Code, CLI commands, file names, paths — always leave in English, format as code: SKILL.md, python scripts/validate.py.
  2. Product names and brands — leave in English: Claude, MCP, Docker, GitHub.
  3. UI menu paths — leave in English if the product has no Russian localization: Settings > Extensions > Claude. On first mention, add a parenthetical Russian gloss: Settings (Настройки) > Extensions (Расширения).
  4. English headings in Russian text — translate the heading, keep the English original only if it's a proper noun or official document title: «## Установка навыка [Your Service]».
  5. Technical terms without established Russian equivalent — use the English term in Latin script, not transliterated: «используйте middleware», not «используйте мидлвару».
  6. Technical terms with established Russian equivalent — use Russian: «навык» (not «скилл»), «рабочий процесс» (not «воркфлоу»), «задача» (not «таск»).

Formatting English within Russian

  • English terms in running Russian text: no special formatting needed if they are code or product names. Use code formatting for technical identifiers.
  • Quoted English phrases kept for reference: use «ёлочки»: Спросите Claude: «When would you use this skill?»
  • Never mix Latin and Cyrillic lookalike characters within a single word.

Heading Style

  • In web documentation, do not use the word «Глава» before section numbers. It adds visual noise without value.
  • Use just the number: «1. Основы», not «Глава 1. Основы».
  • For subsections, use concise noun phrases or questions, not verbose descriptions.

Addressing the Reader

  • For instructions and procedures: use infinitive or first person plural ("Приступим", "Рассмотрим"), not aggressive imperative ("Начинаем!").
  • For step-by-step guides: imperative is fine but should be specific ("Откройте файл", "Проверьте результат"), not vague ("Начните").
  • Avoid stadium-announcer style: "Начинаем." → "Приступим." or simply omit.

Output Format

Return only the finished translation without comments, explanations, or metadata unless otherwise requested.

If the source contains ambiguities or errors affecting translation, note them separately after the translation under heading «Примечания переводчика».

If the user asks to see the full workflow, show all three steps with intermediate results and reflection notes.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.