deepl-translate-nodelisted

# DeepL Translate (confidence-gated fallback) A thin wrapper around the DeepL API. The point of this skill is the **trigger logic**, not the API call: translate with DeepL when your own translation might be wrong and being wrong matters. ## When to reach for DeepL instead of translating yourself Translate it yourself when the text is everyday prose and you are confident. Call DeepL when **any** of these is true: - **Proper nouns / brand / product names** that have official localized forms - **Domain terminology** — legal, medical, financial, technical specs, patents - **Ambiguous source** where one word maps to several target words and context doesn't disambiguate - **Idioms / fixed expressions** that don't translate literally - **Low-resource or distant language pairs** where your training signal is thin - **High-stakes output** — anything the user will publish, sign, or send to a third party, where a subtle error is costly - The user **explicitly asks** for DeepL. If you're confident and the cost of a minor error is low, just translate directly — don't burn an API call. ## Prerequisite: API key The key is read from the `DEEPL_API_KEY` environment variable (never hardcode it). Default endpoint is the **Free** tier host `api-free.deepl.com`; for Pro, set `DEEPL_API_HOST=api.deepl.com`. Set it once: ```bash # macOS / Linux — add to ~/.bashrc or ~/.zshrc to persist export DEEPL_API_KEY="your-deepl-auth-key-here" ``` ```powershell # Windows (persistent, user scope)