feat(engineering): add i18n-localization skill#850
Open
asadbekXodjayev wants to merge 1 commit into
Open
Conversation
Adds an internationalization/localization engineering skill — a gap in the
repo (i18n was only mentioned incidentally inside email-template-builder and
cmo-advisor; no dedicated implementation skill existed).
Covers the discipline end to end: route every user-facing string through one
i18n layer, keep all locale files in sync, format numbers/dates/currency via
Intl (not translation keys), backend-enum mapping, locale-prefixed routing,
pluralization, and RTL.
Ships a stdlib-only Python tool, scripts/locale_key_drift.py, that detects the
four failure modes that ship broken translations across locale files:
missing keys, extra keys, empty values, and placeholder mismatches
({{count}} vs {{cnt}}). CLI-first with --help/--json and exit codes 0/1/2,
so it can gate CI.
- SKILL.md: name+description frontmatter only, 146 lines, opinionated,
anti-patterns + cross-references sections
- references/i18n-patterns.md: namespaces vs flat files, pluralization,
Intl, locale routing, RTL, SSR/Next.js, missing-key strategy
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds an internationalization/localization engineering skill — a gap in the repo (i18n was only mentioned incidentally inside email-template-builder and cmo-advisor; no dedicated implementation skill existed).
Covers the discipline end to end: route every user-facing string through one i18n layer, keep all locale files in sync, format numbers/dates/currency via Intl (not translation keys), backend-enum mapping, locale-prefixed routing, pluralization, and RTL.
Ships a stdlib-only Python tool, scripts/locale_key_drift.py, that detects the four failure modes that ship broken translations across locale files: missing keys, extra keys, empty values, and placeholder mismatches ({{count}} vs {{cnt}}). CLI-first with --help/--json and exit codes 0/1/2, so it can gate CI.
Summary
Checklist
dev(notmain— PRs to main will be auto-closed)SKILL.mdwith valid YAML frontmatter (name,description,license)--helpwithout errorsdomain/skill-name/SKILL.md)Type of Change
Testing