i18n Language Standards & Enforcement
This skill defines, audits, and enforces user-facing language standards across LibrAgent. It ensures that UI labels, settings descriptions, tool documentation, and i18n locales adhere to ASD-STE100 for English and Clear Korean UI Standards for Korean, while maintaining rigorous parity across all 8 supported languages (en, ko, ja, zh, de, fr, es, pt).
1. Core Principles
- No Internal Code Identifiers in UI:
- Never expose code syntax or internal function names in user-facing text.
- Prohibited examples:
browser="userChrome", browser="sidecar", createSession, awaitAgent, pollProcess.
- Eliminate Engineering Jargon:
- Translate compiler, runtime, or ML-serving concepts into clear end-user benefits.
- Replace
prefill, clean resample, circuit breaker, serving-engine, old turns, diffs with intuitive layperson equivalents.
- ASD-STE100 Compliance (English):
- Sentences under 20 words where possible.
- Active voice, clear imperatives, one word for one meaning.
- Clear Korean Standards (한국어):
- 번역투 및 피동형(
~되어지다) 배제, 능동형 단문 구성.
- 불필요한 한자어나 외래어(
거버넌스) 대신 직관적인 표준 용어 사용.
- Multilingual Parity (8 Locales):
- All settings keys and UI strings must maintain semantic and structural parity across
en, ko, ja, zh, de, fr, es, and pt.
2. Automated Validation Workflow
To check compliance across all locale files and Settings components, execute the bundled validator:
node .agents/skills/i18n-language-standards/scripts/validate_i18n_standards.cjs
The script verifies:
- Absence of forbidden internal identifiers in
src/locales/ and src/features/settings/.
- Absence of flagged engineering jargon.
- JSON syntax validity and key parity against
en/common.json.
3. Reference Guides
Consult the reference documents for specific translation rules:
- ASD-STE100 English Guidelines: Active voice, controlled vocabulary, brevity rules.
- Clear Korean UI Guide: 한국어 UI 표준 어휘, 번역투 제거 및 능동형 문체 규약.
- Multilingual Translation Guide: Rules for
ja, zh, de, fr, es, and pt.
1---2name: i18n-language-standards3description: >4 Enforce ASD-STE100 (English) and clear Korean UI language standards across LibrAgent.5 Audits UI text, Settings descriptions, and i18n locales for prohibited engineering jargon,6 internal code identifiers (browser="userChrome", awaitAgent, pollProcess, createSession),7 passive translations, and ensures terminology parity across all 8 supported languages.8 Triggers on: "언어 규약", "language standards", "i18n standards", "ASD-STE100", "i18n audit",9 "i18n 검증", "언어 규약 검사", "layman-friendly UI text", "i18n-language-standards".10metadata:11 source: https://skillmd.com/skills/fritzprix/i18n-language-standards12---1314# i18n Language Standards & Enforcement1516This skill defines, audits, and enforces user-facing language standards across LibrAgent. It ensures that UI labels, settings descriptions, tool documentation, and i18n locales adhere to **ASD-STE100** for English and **Clear Korean UI Standards** for Korean, while maintaining rigorous parity across all 8 supported languages (`en`, `ko`, `ja`, `zh`, `de`, `fr`, `es`, `pt`).1718## 1. Core Principles19201. **No Internal Code Identifiers in UI**:21 - Never expose code syntax or internal function names in user-facing text.22 - Prohibited examples: `browser="userChrome"`, `browser="sidecar"`, `createSession`, `awaitAgent`, `pollProcess`.232. **Eliminate Engineering Jargon**:24 - Translate compiler, runtime, or ML-serving concepts into clear end-user benefits.25 - Replace `prefill`, `clean resample`, `circuit breaker`, `serving-engine`, `old turns`, `diffs` with intuitive layperson equivalents.263. **ASD-STE100 Compliance (English)**:27 - Sentences under 20 words where possible.28 - Active voice, clear imperatives, one word for one meaning.294. **Clear Korean Standards (한국어)**:30 - 번역투 및 피동형(`~되어지다`) 배제, 능동형 단문 구성.31 - 불필요한 한자어나 외래어(`거버넌스`) 대신 직관적인 표준 용어 사용.325. **Multilingual Parity (8 Locales)**:33 - All settings keys and UI strings must maintain semantic and structural parity across `en`, `ko`, `ja`, `zh`, `de`, `fr`, `es`, and `pt`.3435## 2. Automated Validation Workflow3637To check compliance across all locale files and Settings components, execute the bundled validator:3839```bash40node .agents/skills/i18n-language-standards/scripts/validate_i18n_standards.cjs41```4243The script verifies:4445- Absence of forbidden internal identifiers in `src/locales/` and `src/features/settings/`.46- Absence of flagged engineering jargon.47- JSON syntax validity and key parity against `en/common.json`.4849## 3. Reference Guides5051Consult the reference documents for specific translation rules:5253- [ASD-STE100 English Guidelines](references/ste100-guide.md): Active voice, controlled vocabulary, brevity rules.54- [Clear Korean UI Guide](references/korean-ui-guide.md): 한국어 UI 표준 어휘, 번역투 제거 및 능동형 문체 규약.55- [Multilingual Translation Guide](references/multilingual-guide.md): Rules for `ja`, `zh`, `de`, `fr`, `es`, and `pt`.