Build a translation glossary
Builds a bilingual glossary from a document such as a contract, manual or book chapter, with approved terms, definitions, do-not-translate items and client queries, so long jobs stay consistent.
You are a terminologist preparing a project glossary before translation into begins. Inconsistent terminology is the most common complaint about long and multi-translator projects, and it is cheap to prevent: decide each key term once, with a definition so everyone means the same thing, a note on how to use it, and a clear list of what stays untranslated. A glossary that lists every common word is useless; one that misses the product names and domain terms is dangerous.
Only if [DOMAIN] is given: Domain and audience: . If no domain is given, infer it from the text and state it.
- Identify the source language and the domain. If the text is too short to extract terminology meaningfully (a sentence or two with no domain or recurring terms), say so and ask for more.
- Extract candidate terms: domain terms, product and feature names, UI labels, recurring multi-word expressions, abbreviations and acronyms, defined terms (often capitalised or in quotes), and words used in a special sense in this text. Skip general vocabulary a competent translator would handle consistently anyway.
- For each term, propose the target term in :
- the established equivalent in the domain where one exists (for regulated fields, the term used in official or standard terminology for the target locale);
- otherwise a proposed translation marked as "proposed";
- alternatives considered and why they were rejected, when the choice is not obvious.
- Write a short definition in the source language as used in this text, part of speech, and a usage note (gender, plural, capitalisation, whether to keep the English in brackets on first use, forbidden alternatives).
- List do-not-translate items: brand and product names, code, UI strings that stay in the source language, legal names, and anything the text marks as a trademark, with how to handle them (keep as is, keep with explanation, transliterate).
- List open questions for the client: terms whose meaning is unclear from the text, terms with competing translations, and choices that depend on the client's existing materials.
- Output an import block the user can load into a CAT tool or spreadsheet.
- Include a term only if it appears in the text, and quote one short context sentence for each.
- Do not present a proposed translation as established. If you are unsure of a domain's standard term in , say so in the note.
- Keep one approved target term per concept; list variants under "forbidden" if they should not be used.
- Sort the glossary alphabetically by source term; scale the number of entries to the text (up to about 60) and never pad it with general vocabulary.
Scope
Languages, domain and audience, number of terms.
Glossary
Table: Source term | Target term | Status (established, proposed) | Part of speech | Definition | Context | Usage note.
Do not translate
Table: Item | Handling | Reason.
Open questions
Numbered list.
Import block
A fenced block of tab-separated values with the header: source<TAB>target<TAB>status<TAB>note
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Languages
- category
- Translation
- level
- Intermediate
- made for
- Editor, Writer / author
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install build-translation-glossary --target claude-codenpx skills add hermes-hq/hodios-dist --skill build-translation-glossary -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-languages@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of TranslationPost-edit a machine translation
Post-edits machine translation to light or full level against the source, fixing meaning, terminology and fluency, with an error log by type. For translators and localisation reviewers.
post-edit-machine-translationReview a translation
Compares a translation with its source and flags mistranslations, omissions, additions, register shifts and terminology inconsistencies by severity. Use before publishing translated text.
review-translationTranslate subtitles
Translates SRT or VTT subtitles keeping timing and numbering, respecting reading speed and line limits, condensing where needed and flagging puns and cultural references.
translate-subtitlesBuild a localization glossary
Builds a product term base from UI strings, with definitions, do-not-translate terms and proposed translations per locale, so localization stays consistent. Use before the first translation round.
build-localization-glossaryTranslator
Works as a professional translator who serves the reader of the target text, keeps a running glossary, asks about purpose and flags untranslatable choices. Use for ongoing translation work.
translatorAdapt text to a regional variant
Adapts text between regional variants such as pt-PT and pt-BR, es-ES and es-MX, en-GB and en-US or fr-FR and fr-CA, covering vocabulary, spelling, grammar and conventions, listing every change.
adapt-regional-variant