add-language

Add a new language translation to the IGOOR application across locale files, plugins, and settings.

8|1|Updated Feb 24, 2025
One-click install
npx skills add https://github.com/igoor-noprofit/igoor --skill add-language-igoor-noprofit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-language
Source: https://github.com/igoor-noprofit/igoor/tree/main/.claude/skills/add-language
Command: npx skills add https://github.com/igoor-noprofit/igoor --skill add-language-igoor-noprofit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new language to the IGOOR application requires touching dozens of files: global locale JSON, per-plugin translation files, biorecorder questionnaires, settings dictionaries, onboarding dropdowns, ASR/TTS model configs, and the MSIX manifest. This Skill automates that entire multi-step workflow so nothing is missed. ## Core Features & Use Cases - Complete locale generation: Creates global common/default-settings files and per-plugin translation JSON files for every plugin, translating French reference values into the target language while preserving English keys and {param} placeholders. - Code and config updates: Edits settings_manager.py (LANG_TO_NAME, LANG_STYLE_NOTES), the onboarding Vue dropdown, Speechify/PocketTTS language maps, Sherpa ASR model catalog, and the MSIX AppxManifest resources. - Validation and reporting: Runs key-count comparisons, JSON syntax checks, Python compile checks, and produces a summary report with ASR/TTS compatibility warnings. - Use Case: Run /add-language es_ES Spanish to generate all Spanish translations, wire up language settings, verify Whisper/Sherpa model support, and get a completeness report. ## Quick Start Ask the AI to add Spanish language support to the IGOOR app using locale code es_ES.

Frequently Asked Questions about add-language

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new language to the IGOOR app?

Run the skill with a locale code and language name, for example /add-language es_ES Spanish. It creates all locale JSON files, translates plugin strings from the French reference, updates settings_manager.py, and validates the results.

How are IGOOR plugin translation files structured?

Plugin translation files are flat JSON objects where keys are English strings and values are translations, stored at plugins/{plugin}/locales/{lang}/{plugin}_{lang}.json. The biorecorder questions file is the exception, using a nested category structure.

Does adding a language require ASR and TTS model changes?

Yes, partially. The skill checks Sherpa-ONNX model availability in sherpa_models.json, adds the locale to Speechify's supported_lang list and PocketTTS language maps, and warns if no wakeword .onnx model exists. Cloud ASR and ElevenLabs need no code changes.

Why do translations fall back to English for some strings?

The t() method returns the English key directly when a translation key is missing from the locale file. The skill prevents this by comparing key counts against the fr_FR reference and reporting missing or extra keys during validation.

What locale code format does the skill accept?

Locale codes must match the pattern {ll}_{CC}, such as es_ES, de_DE, or pt_BR. The skill validates the format before starting and derives base language codes and BCP-47 tags from it for ASR configs and the MSIX manifest.