hermes

Build 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.

context

Without a glossary, each translator and each release picks its own word for the product's core concepts, so "Workspace" becomes three different words in German across one screen, and "Archive" and "Delete" blur together in a language where the first guess was a synonym. A good term base is short, covers the terms that carry product meaning or appear everywhere, defines each one so translators understand the concept rather than the English word, and settles brand names once.

task

Build a localization glossary from these strings:

Target locales: Product context:

  1. Extract candidate terms:
  • product objects and features ("Workspace", "Board", "Snapshot");
  • recurring UI actions whose differences matter ("Archive" versus "Delete" versus "Remove", "Sign in" versus "Log in");
  • domain terms that users must understand precisely;
  • brand, product and plan names, and code-like tokens. Skip generic words that any translator handles consistently.
  1. Check the source for its own inconsistencies first: the same concept named two ways, or one word used for two concepts. Report them, because they must be fixed in the source or the glossary will encode the confusion.
  2. For each term, record its part of speech, a one-sentence definition of the concept in this product, a real usage example taken from the strings, and whether it is do-not-translate.
  3. Propose a translation per locale:
  • For standard concepts (Settings, Preferences, Sign in, Share), follow the target platform's published UI terminology; Microsoft and Apple both publish localized term lists. Note where the two differ.
  • For inflected languages, give the grammatical gender and the plural form.
  • Pick a translation that keeps distinct source terms distinct.
  • Note forbidden alternatives where a common choice would be wrong ("Do not use 'Löschen' for Archive").
  • Mark every proposal as "proposed" for a native-speaking reviewer to approve.
  1. Keep the glossary focused: at most 40 terms, ordered by how often they appear and how much meaning they carry.
  2. If the product context is missing and the strings do not make the concepts clear, ask up to 3 questions about the terms that matter most, and build the rest.
constraints
  • Never present a proposed translation as approved or authoritative.
  • Do-not-translate terms are only brand names, product names, trademarks, code identifiers and terms the context says to keep. Ordinary words are not do-not-translate just because they are capitalised.
  • Separate what you verified from what you inferred. Mark inferences as such.
  • When you do not know, say "I don't know" once and state what would settle it.
output format

Source inconsistencies

| Concept | Variants found | Example keys | Recommended single term | "None" if there are none.

Glossary

| Term | Part of speech | Definition | Example from the strings | One column per locale: proposed translation (gender and plural where relevant) | Notes and forbidden alternatives |

Do not translate

One line each, with the reason.

Export

The glossary as CSV in a code block, with columns term,pos,definition,dnt,<locale>...,notes, ready to import into a translation management tool.

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
Software engineering
category
Localization (software)
level
Intermediate
made for
Product manager, Technical writer, Software engineer
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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install build-localization-glossary --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill build-localization-glossary -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the software-engineering plugin
claude plugin install hodios-software-engineering@hodios

The plugin brings every entry in this domain at once.

PromptLocalization (software)

Translate a software string catalog

Translates a software string file (JSON, PO, XLIFF, ARB, Android or Apple strings) keeping keys, placeholders, plurals and length limits intact. Use when localizing an app's UI text.

translate-string-catalog
PromptLocalization (software)

QA a translated string catalog

QA-checks a translated catalog against its source for placeholder mismatches, broken syntax, truncation risk, terminology drift and untranslated strings. Use before merging translations.

review-translated-strings
WorkflowLocalization (software)

App localisation track

Takes an English-only app to its first extra language in gated steps, from readiness scan and string extraction to formatting fixes, pseudo-localisation, translation hand-off and linguistic QA.

app-localization-track
PromptLocalization (software)

Automate translation file sync

Designs the pipeline between a repo and translators, with key extraction, upload to a translation system or vendor, download of finished locales, CI checks for keys and fallbacks, and approvals.

automate-translation-file-sync
PromptLocalization (software)

Design international name and address fields

Designs form fields, validation and storage for personal names, postal addresses and phone numbers that work across countries. Use for international sign-up, checkout or shipping forms.

design-international-address-and-name-fields
PromptLocalization (software)

Design locale detection and routing

Designs how a web or mobile app picks and remembers language and region, with negotiation, explicit choice, URL strategy, hreflang, fallback chains and language kept separate from currency.

design-locale-detection-and-routing