Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
shino369 avatar

Translation Expertise

  • 628 installs
  • 3 repo stars
  • Updated January 13, 2026
  • shino369/claude-code-personal-workspace

translation-expertise is a Claude agent skill that applies English, Japanese, and Traditional Chinese translation rules for developers who need accurate localization of docs, UI strings, and support copy for Taiwan and H

About

translation-expertise is a shino369/claude-code-personal-workspace agent skill providing trilingual translation methodology for English, Japanese, and Traditional Chinese. Five bundled reference files—english.md, japanese.md, chinese-traditional.md, translation-challenges.md, and tools-resources.md—cover measure words, five Japanese keigo levels, Taiwan and Hong Kong regional variants, and four-character idioms. The workflow includes glossary creation, section-by-section translation, proofreading for particles and classifiers, terminology consistency, and cultural adaptation while preserving tone. Developers reach for translation-expertise when localizing software docs, in-app strings, or support articles between EN, JA, and zh-TW pairs. The skill emphasizes meaning over literal mapping and natural target-language flow with explicit quality assurance steps. Skip for single-language copywriting without cross-locale grammar constraints.

  • Reference corpus for Traditional Chinese structural and grammatical conventions (SVO, aspect markers, 量詞)
  • Distinguishes 繁體字 usage for Taiwan, Hong Kong, and Macau versus Simplified norms
  • Covers omission, topic-prominent phrasing, and 成語 idioms agents often mishandle in EN→ZH-TW work
  • Explains tone and aspect particles (了, 過, 著) for natural tense and completion in translation
  • No executable automation—pure linguistic expertise for agent-mediated translation tasks

Translation Expertise by the numbers

  • 628 all-time installs (skills.sh)
  • +12 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #353 of 1,879 Documentation skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/shino369/claude-code-personal-workspace --skill translation-expertise

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs628
repo stars3
Security audit3 / 3 scanners passed
Last updatedJanuary 13, 2026
Repositoryshino369/claude-code-personal-workspace

How do you localize UI strings to Traditional Chinese accurately?

Give your agent Traditional Chinese (繁體) grammar, measure words, and register rules so docs, UI strings, and support copy localize accurately for Taiwan/Hong Kong audiences.

Who is it for?

Developers localizing software for zh-TW, zh-HK, or Japanese markets who need grammar, keigo, and measure-word reference during translation.

Skip if: Developers needing only English copywriting or fully automated machine translation without cultural adaptation review.

When should I use this skill?

User asks to translate content between English, Japanese, or Traditional Chinese for docs, UI strings, or support copy.

What you get

Localized docs and UI copy, terminology glossaries, and proofread translations with measure-word and register corrections.

  • Localized copy
  • Terminology glossary
  • Proofread translations

By the numbers

  • Covers 3 languages with 5 bundled reference files
  • Documents 5 Japanese keigo politeness levels
  • Includes 4 tones in Mandarin and 6-9 in Cantonese writing guidance

Files

SKILL.mdMarkdownGitHub ↗

Translation Expertise

Overview

This skill provides comprehensive translation expertise for English, Japanese, and Traditional Chinese. It covers translation methodologies, cultural considerations, and best practices for producing high-quality translations.

Translation Philosophy

Core Principles

1. Meaning over Literalness: Convey the intended meaning rather than word-for-word translation 2. Cultural Adaptation: Adapt content for the target culture while preserving the original intent 3. Natural Flow: Translations should read naturally in the target language 4. Contextual Accuracy: Consider the broader context, not just individual words 5. Tone Preservation: Maintain the original tone (formal, casual, technical, emotional)

Language-Specific References

For comprehensive information about each language, see the dedicated language reference files:

English

Key Features: SVO word order, explicit subjects and articles, direct communication style, active voice preference.

Contains: Structural features, formality indicators (informal/formal/academic), punctuation conventions, common idioms, phrasal verbs, modal verbs, translation strategies, regional variations (US/UK).

Japanese (日本語)

Key Features: SOV word order, context-dependent subject omission, three writing systems (hiragana, katakana, kanji), elaborate honorific systems (keigo).

Contains: All five politeness levels (plain, polite, respectful, humble, beautification) with detailed explanations, gendered speech patterns, particle usage, writing system guidelines, translation strategies, cultural concepts.

Chinese Traditional (繁體中文)

Key Features: SVO word order like English, no verb conjugation, measure words (classifiers) for counting, rich idiomatic expressions (成語).

Contains: Comprehensive measure word list, regional variations (Taiwan/Hong Kong/Macau), four-character idioms (成語), formality indicators, punctuation conventions, translation strategies, terminology differences.

Quick Reference: For translation work between any language pair, open both relevant language files side-by-side for comprehensive reference.

Translation Workflow

Step 1: Initial Translation

Process:

1. Read the entire source text to understand context and intent 2. Identify key terminology and create a glossary 3. Translate section by section, maintaining context 4. Mark uncertain translations for review

Considerations:

  • Understand the source culture and references
  • Identify the target audience
  • Determine appropriate formality level
  • Note any ambiguities requiring clarification

Step 2: Proofreading & Review

Grammar and Syntax Check:

  • Verify sentence structure is natural in target language
  • Check verb tenses and aspects
  • Ensure particles (JA) or measure words (ZH) are correct
  • Validate punctuation follows target language conventions (see language-specific files)

Terminology Consistency:

  • Ensure consistent translation of key terms
  • Verify technical terms are accurate
  • Check proper nouns are handled correctly
  • Confirm units and measurements are appropriate

Cultural Adaptation:

  • Verify idioms are culturally appropriate (see translation-challenges.md)
  • Check for culturally sensitive content
  • Ensure examples and analogies work in target culture
  • Adapt humor if necessary

Tone and Style:

  • Maintain consistent tone throughout
  • Ensure formality level matches the source
  • Verify the text flows naturally
  • Check that emphasis and nuance are preserved

Step 3: Refinement Translation

Enhancement Process:

1. Review feedback from proofreading 2. Resolve all marked uncertainties 3. Improve awkward phrasings 4. Polish for naturalness and readability 5. Final consistency check

Quality Markers:

  • Reads naturally to native speakers
  • Accurately conveys source meaning
  • Maintains appropriate tone and style
  • Consistent terminology throughout
  • Free of grammatical errors

Common Translation Challenges

Detailed Examples: See translation-challenges.md for extensive examples with reasoning.

Challenge 1: Idioms and Expressions

Strategy: Find equivalent expressions, not word-for-word translations.

Examples: "Break a leg" → 頑張って (JA) / 加油 (ZH); "Piece of cake" → 朝飯前 (JA) / 小菜一碟 (ZH)

Challenge 2: Cultural References

Strategy: Adapt or explain references unfamiliar to target culture.

Approaches: Direct + explanation, cultural adaptation to equivalent concept, or generalization depending on context importance.

Challenge 3: Wordplay and Puns

Strategy: Recreate the effect, not the exact wordplay.

Approach: Either explain the original wordplay with translator's note, or create new language-specific wordplay that achieves similar humor effect.

Challenge 4: Formality Levels

Strategy: Match formality indicators across languages.

Key: English uses vocabulary and contractions; Japanese uses verb endings and honorifics; Chinese uses vocabulary and pronouns (你/您).

Challenge 5: Ambiguity Resolution

Strategy: Use context clues, research, and informed judgment when source is ambiguous.

Process: Analyze context, research domain-specific meanings, apply logic, choose most likely interpretation, and document reasoning.

For Detailed Examples: See translation-challenges.md for comprehensive examples with solutions.

Punctuation Quick Reference

Key Differences (See language-specific files for complete details):

  • Period: . (EN) → 。(JA/ZH)
  • Comma: , (EN) → 、(JA) / 、or , (ZH)
  • Quotation marks: "..." (EN) →「...」(JA/ZH) or "..." (ZH alternative)
  • Book titles: "..." (EN) → 『...』(JA) /《...》(ZH)
  • Ellipsis: ... (EN) → …… (JA/ZH - six dots)

Important: Use full-width punctuation for Japanese and Chinese text. Maintain consistency throughout the document.

Detailed Conventions: See english.md, japanese.md, or chinese-traditional.md for complete punctuation rules.

Quality Assurance Checklist

Before finalizing any translation:

Accuracy:

  • [ ] Meaning accurately conveyed
  • [ ] No omissions or additions
  • [ ] Numbers, dates, names correct
  • [ ] Technical terms accurate

Naturalness:

  • [ ] Reads fluently in target language
  • [ ] No awkward phrasings
  • [ ] Appropriate word choice
  • [ ] Natural sentence flow

Consistency:

  • [ ] Terminology used consistently
  • [ ] Tone maintained throughout
  • [ ] Formatting preserved
  • [ ] Style guide followed

Cultural Appropriateness:

  • [ ] Culturally sensitive content handled well
  • [ ] Idioms adapted appropriately
  • [ ] References understandable to target audience
  • [ ] Examples relevant to target culture

Technical Correctness:

  • [ ] Grammar correct
  • [ ] Punctuation follows conventions
  • [ ] Character encoding correct (UTF-8)
  • [ ] No typos or errors

Best Practices

1. Always Translate in Context: Never translate sentences in isolation 2. Maintain Terminology Consistency: Use glossaries and translation memories 3. Research Thoroughly: Look up unfamiliar terms and verify meanings 4. Read Aloud: Natural translations sound good when read aloud 5. Get Feedback: Have native speakers review when possible 6. Iterate: First draft is rarely perfect, refinement is essential 7. Document Decisions: Keep notes on difficult translation choices 8. Stay Updated: Language evolves, keep learning new expressions and terms 9. Know Your Limits: Flag areas requiring subject matter expertise 10. Preserve Intent: When in doubt, prioritize the author's intended meaning

Tools and Resources

Comprehensive List: See tools-resources.md for detailed resources.

Essential Dictionaries:

  • Jisho.org (Japanese-English)
  • MDBG (Chinese-English)
  • MOE Dictionary (Chinese official)
  • Weblio (Japanese)

Example Sentences:

  • Tatoeba (multilingual examples)
  • Reverso Context (translation in context)

Grammar References:

  • Tae Kim's Grammar Guide (Japanese)
  • Chinese Grammar Wiki (Chinese)
  • Purdue OWL (English)

Verification Tools:

  • HiNative (ask native speakers)
  • Google N-gram Viewer (frequency analysis)
  • Reddit language communities
For Complete Resource List: See tools-resources.md for comprehensive dictionaries, corpora, grammar references, verification tools, and professional resources.

Companion Files

This skill includes the following companion documents for detailed reference:

Language-Specific References

1. [english.md](./english.md): Complete English language reference including structural features, formality indicators, punctuation conventions, common idioms, phrasal verbs, modal verbs, and translation strategies.

2. [japanese.md](./japanese.md): Complete Japanese language reference including all five politeness levels, gendered speech patterns, particle usage, writing system guidelines, and cultural concepts.

3. [chinese-traditional.md](./chinese-traditional.md): Complete Traditional Chinese language reference including measure words, regional variations (Taiwan/Hong Kong/Macau), four-character idioms (成語), and formality indicators.

Cross-Language References

4. [translation-challenges.md](./translation-challenges.md): Extensive examples of common translation challenges with detailed solutions, reasoning, and multiple approaches for idioms, cultural references, wordplay, formality, and ambiguity.

5. [tools-resources.md](./tools-resources.md): Curated list of dictionaries, corpora, grammar references, verification tools, and professional resources organized by category and language.

Quick Reference

When translating, remember:

1. Read entire source text first for context 2. Create terminology glossary for consistency 3. Choose appropriate formality level early 4. Handle idioms culturally, not literally 5. Verify punctuation conventions for target language 6. Proofread for naturalness and accuracy 7. Get native speaker feedback when possible 8. Document difficult translation decisions

Default choices when uncertain:

  • Japanese: Use です/ます polite form unless clear context suggests otherwise
  • Chinese: Use 您 for formal contexts, 你 for casual; prefer Taiwan terminology unless specified
  • Punctuation: Use「」for quotes in JA/ZH Taiwan style; use《》for book titles in Chinese
  • Idioms: When direct equivalent unclear, prioritize conveying meaning over preserving metaphor

---

Note: This is a core skill for trilingual translation work. For writing conventions specific to each language (document structure, essay formats, rhetorical patterns), see the document-writing skill. For technical terminology, see the engineering-terminology skill.

Related skills

FAQ

Which languages does translation-expertise cover?

translation-expertise covers English, Japanese, and Traditional Chinese with dedicated reference files english.md, japanese.md, and chinese-traditional.md plus translation-challenges.md and tools-resources.md.

What Chinese regions does translation-expertise address?

translation-expertise addresses Taiwan, Hong Kong, and Macau regional variants in chinese-traditional.md, including measure words, 成語 idioms, and formality register rules for zh-TW localization.

Does translation-expertise include Japanese honorific guidance?

translation-expertise includes japanese.md covering five keigo politeness levels—plain, polite, respectful, humble, and beautification—plus particle usage and writing system guidelines for software copy.

Is Translation Expertise safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Documentationworkflownotes

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.