← Explore all skills

TEXT TRANSLATION / Microsoft

Azure AI Text Translation for Python

Pins Microsoft's Python text-translation skill, which requires a custom subdomain for token auth and keeps the global endpoint on key plus region.

“Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications. Triggers: "text translation", "translator", "translate text", "transliterate", "TextTranslationClient". ”

01 / THE REASONING

Why this made the selection.

  • The file says token-credential auth requires a custom subdomain, and that a global endpoint must stay on the key-based path until a custom subdomain exists.
  • It says key plus region is the setup against the global endpoint, while new code should still use DefaultAzureCredential when a custom subdomain is available.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • .github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md
  • README.md
  • .github/plugins/azure-sdk-python/README.md
  • LICENSE

Our findings

  • The file says to prefer DefaultAzureCredential and to avoid connection strings and API keys because they bypass Entra audit and rotation.
  • It says production must set AZURE_TOKEN_CREDENTIALS to prod, or to one named credential, to constrain the credential chain.
  • It says token-credential auth requires a custom subdomain endpoint, and a caller who only has the global endpoint must provision one or stay on the key-based path.
  • It says key plus region is the canonical setup against the global endpoint, and the region is required for a multi-service or global Translator key.
  • It says a key against a custom subdomain endpoint does not require a region.

Not established by this review

  • The resource was not executed and its tools were not called.
  • No Azure client was constructed and no credential was used.
  • The linked reference files were not opened.
  • The azure-sdk-python plugin was not installed.
  • No text was translated and no endpoint type was probed.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

/plugin install azure-sdk-python@skills

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. The plugin README shows `/plugin install azure-sdk-python@skills`. That installs the azure-sdk-python plugin, not this one file.
  2. The same README also shows `npx skills add microsoft/skills --skill azure-sdk-python`.
  3. The repository README shows `npx skills add microsoft/skills`, which starts a wizard for the repository, and `/plugin install azure@skills` for a different plugin.
  4. The skill shows `pip install azure-ai-translation-text` for the SDK package. That line was not run.

Before you start

  • Python if the skill's pip line is run; this review did not run it
  • A custom subdomain endpoint for Entra ID, or a key and region for the global endpoint, as the skill distinguishes those paths
  • AZURE_TOKEN_CREDENTIALS when production uses DefaultAzureCredential, as the skill's environment block says

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md

    Supports: custom-subdomain token auth, global-endpoint key plus region, and the production credential constraint

  2. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/README.md

    Supports: /plugin install azure-sdk-python@skills installs the plugin, not one file

  3. Repository README ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md

    Supports: MIT statement, Copilot CLI plugin install, and a different azure plugin command

  4. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: MIT License

  5. https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md

    Supports: upstreamDescription, bestFor, review.notTested

Evidence & Ask