A workflow for adding languages and translation text to an application's internationalisation system. Internationalisation, often shortened to i18n, lets one application show text in multiple languages.

Use it when adding a language, changing translated text, or creating a new translation key.

It keeps translation keys consistent across the application's language files and checks that the compiled translations are complete.

How Hackbyrd/orbital-express configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to Hackbyrd/orbital-express. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/Hackbyrd/orbital-express/main/.claude/skills/add-locale/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/Hackbyrd/orbital-express

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/hackbyrd/orbital-express/add-locale/github.svg)](https://agentmods.dev/skills/hackbyrd/orbital-express/add-locale)

Your own site

<a href="https://agentmods.dev/skills/hackbyrd/orbital-express/add-locale"><img src="https://agentmods.dev/badge/skills/hackbyrd/orbital-express/add-locale/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/hackbyrd/orbital-express/add-locale"><img src="https://agentmods.dev/badge/skills/hackbyrd/orbital-express/add-locale.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 853 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00060	$0.00853
Opus 5.5	$0.00024	$0.00341
Sonnet 5.5	$0.00012	$0.00171
Haiku 4.5	$0.00006	$0.00085

Measured 2mo ago against content hash f1aef525c1d9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

add-locale scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/add-locale/SKILL.md · 32 lines

How it starts

The opening of the file, as written. The whole thing — 32 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Add a locale / translation keys

i18n source files are co-located per feature (app/<Feature>/languages/<locale>.js) plus the global languages/<locale>.js. They compile into locales/<locale>.json via yarn lang — never edit locales/*.json directly. Read README "Global Languages / Locales". For the full deep reference, see docs/core/errors.md.

Plan the locale/key contract, fallback/copy, affected features, and tests and get sign-off before editing. Every affected feature must retain complete standard structure.

Add (or edit) a translation key

Add the key to the relevant languages/en.js (feature-level for feature strings, global languages/en.js for shared). Format: NAMESPACE[snake_case] — NAMESPACE = feature name ALL_CAPS or GLOBAL; key lowercase_with_underscores. Interpolate with {{var}}.
Add the same key to every other locale file that exists (each locale must have the same keys).
Run yarn lang — it compiles locales/ and validates that every static .__('KEY') in the code exists. It throws in test/prod on missing keys (and yarn test runs it first), so always run it after editing.
Use it: req.__('NAMESPACE[key]', { var }) in actions, i18n.__(...) (from getLocalI18n()) in tasks/services.

Add a brand-new locale (e.g. 'es')

Add the locale code to the LOCALES array and LOCALE map in helpers/constants.js (LOCALE keys are UPPER_CASE: { EN: 'en', ES: 'es' }; LOCALES: ['en','es'], first index is the default).
Add the global languages/<locale>.js. For every feature, run yarn repair <Feature> --dry-run, review, then yarn repair <Feature> so the shared generator template creates the missing feature locale without overwriting files.
Fill every generated app/*/languages/<locale>.js with the full mirrored key set, then run yarn lang.

Using translations: actions vs tasks

In an Express action: locale is set automatically (detection order: req.user.locale → lang in req.args → i18n-locale cookie → default en). Never call setLocale manually. Use req.__('NS[key]', { var }) or res.__(...).
In a task/service (no req): get a fresh instance and set the locale yourself — const i18n = lang.getLocalI18n(); i18n.setLocale(job.data.locale || 'en'); then i18n.__('NS[key]'). When enqueuing a job that produces user-facing strings, pass locale: req.user.locale in job.data.
Never require('i18n') directly in a task/service — shared state bleeds across concurrent jobs. Always getLocalI18n().

Read the full file on GitHub · 32 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 32 lines · 60 tokens per session scan A f1aef525c1d9

Subscribe to this mod's changes

add-locale is a skill published in the GitHub repository Hackbyrd/orbital-express (15 stars, last pushed 2mo ago), licensed MIT. It adds 60 tokens to every session and 853 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Localization

intl-expansion

International market expansion strategy. Market selection, entry modes, localization, regulatory compliance, and go-to-market by region. Use when expanding to new countries, evaluating international markets, planning localization, or building regional teams.

alirezarezvani/claude-skills · 46 tokens

chinese-documentation

A Chinese technical-documentation style guide covering spacing, punctuation, numbers, terminology, and links when Chinese and English appear together.

jnMetaCode/superpowers-zh · 62 tokens

azure-ai-translation-text-py

Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications. Triggers: "text translation", "translator", "translate text", "transliterate", "TextTranslationClient".

microsoft/skills · 60 tokens

harden

Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. Use when the user asks to harden, make production-ready, handle edge cases, add error states, or fix overflow and i18n issues.

fengshao1227/ccg-workflow · 62 tokens

edit-site

Plans, coordinates and customizes PAC CLI-downloaded Standard or Enhanced data model non-SPA Power Pages sites created from Microsoft templates or manually in Design Studio. Use for requests involving pages, localized content, navigation, assets, snippets, site markers, Liquid/web templates, page layouts, or styling.…

microsoft/power-platform-skills · 104 tokens

asc-subscription-localization

Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.

rorkai/app-store-connect-cli-skills · 60 tokens

orbital-express: Skill for Claude Code