i18n Translator Skill

Batch translate JSON locale files using a local LLM via LM Studio. Preserves JSON structure, placeholders, and validates output.

Commands

Examples

/creo i18n translate en uk,pl,de
/creo i18n translate en fr
/creo i18n validate
/creo i18n status

Prerequisites

• Python 3.8+ with requests package
• LM Studio running locally on port 1234 (default) with a loaded model
• Source JSON locale files in the input/ directory

Supported Languages (39+)

You can specify any language code supported by your LLM model.

How It Works

1. Source files: Place JSON locale files in the input/ directory
2. Configure: Edit config.json to set source language, target languages, and LM Studio URL
3. Translate: The translator walks each JSON file recursively, sending each string value to the LLM with context (the JSON key path)
4. Validate: After translation, the validator checks that every translated file has the exact same structure as the source
5. Output: Translated files are saved to output/<lang>/ preserving the original directory structure

Quality Checks

• Placeholder preservation: All {variable} placeholders are verified and restored if the LLM renames or removes them
• Arrow artifact removal: Common LLM artifacts like "text -> translation" are automatically cleaned
• Multi-line response handling: If the LLM returns multiple lines, the best one (closest in length to the original) is selected
• Quote stripping: Spurious wrapping quotes are removed
• Structure validation: Post-translation validation ensures every key exists and types match
• Incremental translation: Only changed values are re-translated; existing translations are preserved

Workflow

Quick Start

# 1. Ensure LM Studio is running with a model loaded on port 1234

# 2. Set up your project
mkdir -p input
cp path/to/your/en/*.json input/

# 3. Edit config.json to list target languages
# 4. Run translation
python3 scripts/run_translation.py

Configuration

Edit config.json:

{
    "source_language": "en",
    "target_languages": ["uk", "pl", "de", "fr"],
    "lm_studio_url": "http://localhost:1234",
    "model": "local-model",
    "temperature": 0.2,
    "request_delay": 1.0,
    "max_retries": 3
}

Create a config_local.json to override settings without modifying the shared config.

Agent Integration

When invoked via /creo i18n translate, the agent will:

1. Check that LM Studio is reachable
2. Locate or create the config.json with requested languages
3. Run the translation scripts
4. Validate the output
5. Report results with any issues found

File Structure

extensions/i18n-translator/
  config.json          # Translation configuration
  requirements.txt     # Python dependencies
  scripts/
    translator.py      # Core translation engine
    run_translation.py # Orchestrator (translate + validate)
    validator.py       # Structure validation
  skills/
    creo-i18n/
      SKILL.md         # This file
  agents/
    creo-i18n.md       # Subagent definition