i18n-language-standards

Enforce ASD-STE100 (English) and clear Korean UI language standards across LibrAgent. Audits UI text, Settings descriptions, and i18n locales for prohibited engineering jargon, internal code identifie

SKILL.md

GitHub

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

  1. 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.
  2. 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.
  3. ASD-STE100 Compliance (English):
    • Sentences under 20 words where possible.
    • Active voice, clear imperatives, one word for one meaning.
  4. Clear Korean Standards (한국어):
    • 번역투 및 피동형(~되어지다) 배제, 능동형 단문 구성.
    • 불필요한 한자어나 외래어(거버넌스) 대신 직관적인 표준 용어 사용.
  5. 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: