Skip to main content
skill CX Codex

azure-translator — Claude Code skill: translate and localize

Skill for Azure Translator development: REST API, SDK, Custom Translator, glossaries, batch document translation, and Docker containers. Requires network access and an Azure Translator key.

CC-BY-4.0 171 installs ★ 818 updated 2026-11-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-translator -a claude-code
Open on GitHub

What azure-translator does

The skill bundles troubleshooting (HTTP status codes, container startup errors), best practices for data preparation and Custom Translator training, region and infrastructure selection, limits and quotas, security setup (keys, Entra ID, VNet, customer-managed keys), API parameters, and integration patterns via REST and SDK.

It fetches live documentation using mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. If metadata is older than three months, it suggests pulling the latest version from the repository.

Covers text translation via API, batch document workflows, training and testing custom models, glossary configuration, Docker deployment on local or on-premises infrastructure, and API version migration.

What it helps with

  • translate large document batches through the API
  • train a custom model on domain-specific terminology
  • choose a region and infrastructure for Translator deployment
  • configure secure access via VNet and customer-managed keys
  • debug container startup errors and HTTP response codes

Example prompts for the agent

  • Help me train a Custom Translator model for medical text with my domain data
  • How do I set up a glossary and run a batch document translation job?
  • What are the rate limits and text size limits for Azure Translator?

How to install azure-translator

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-translator -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-translator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-translator/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-translator

How do I install azure-translator in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-translator -a claude-code, then open ~/.claude/skills/azure-translator/SKILL.md.

What does this skill do?

It provides reference material for Azure Translator development: troubleshooting errors, best practices, model and region selection, security configuration, API parameters, and Docker deployment.

What are the requirements to use this skill?

You need network access, an Azure Translator key, and the mcp_microsoftdocs:microsoft_docs_fetch tool (or fetch_webpage as fallback) to retrieve documentation.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-translator
description: Expert knowledge for Azure Translator development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Translator REST/SDK APIs, Custom Translator, glossaries, batch document jobs, or Docker containers, and other Azure Translator related development tasks. Not for Azure AI Language (use azure-language-service), Azure Speech in Foundry Tools (use azure-speech).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-01"
  generator: "docs2skills/1.0.0"
---
# Azure Translator Skill

This skill provides expert guidance for Azure Translator. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

## How to Use This Skill

> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file

> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

This skill requires **network access** to fetch documentation content:
- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.

## Category Index

| Category | Lines | Description |
|----------|-------|-------------|
| Troubleshooting | L36-L41 | Diagnosing and fixing Azure Translator errors: container startup/runtime issues, usage/FAQ problems, known service bugs, and interpreting HTTP status/error codes for troubleshooting. |
| Best Practices | L42-L51 | Best practices for preparing training data, training Custom Translator models, using glossaries, building reliable batch document workflows, and operational guidance/FAQs for Azure Translator. |
| Decision Making | L52-L61 | Guidance on choosing models, regions, and infrastructure, plus planning and executing migrations/upgrades between Translator API versions and Custom Translator platforms. |
| Limits & Quotas | L62-L67 | Language, locale, and feature availability for Azure Translator/Translator Pro, plus text and document size, rate, and usage limits and quotas. |
| Security | L68-L79 | Securing Azure Translator: auth (keys, Entra ID, SAS, managed identities), firewall/VNet access, customer-managed keys, and secure deployments (incl. Foundry Tools). |
| Configuration | L80-L101 | Configuring Azure Translator: resource setup, containers, Custom Translator projects, API parameters (translate/detect/dictionary), tagging, profanity filters, alignment, transliteration, and monitoring usage. |
| Integrations & Coding Patterns | L102-L140 | Using Translator REST APIs, SDKs, and containers for text/document translation, including batch jobs, status queries, formats, custom models, glossaries, and integration patterns. |
| Deployment | L141-L144 | Running Translator as a Docker container: setup, configuration, authentication, environment variables, and deployment best practices on local or on-prem infrastructure. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Diagnose and mitigate known issues in Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/known-issues |
| Interpret Azure Translator HTTP status and error codes | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/status-response-codes |

### Best Practices
| Topic | URL |
|-------|-----|
| Prepare and filter training data for Custom Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/data-filtering |
| Prepare and upload Custom Translator training documents | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-training-documents |
| Train Custom Translator models with proper datasets | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model |
| Create and apply glossaries in Document translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries |
| Implement reliable end-to-end batch document translation workflow | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/end-to-end-batch-workflow |
| Operational guidance and FAQs for Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/faq |

### Decision Making
| Topic | URL |
|-------|-----|
| Evaluate and compare Custom vs baseline Translator models | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model |
| Plan and execute Custom Translator platform upgrade | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade |
| Choose and prepare infrastructure for Translator document workflows | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/prerequisites |
| Choose Azure Translator regions and endpoints | https://learn.microsoft.com/en-us/azure/ai-services/translator/region-support |
| Decide and migrate from Translator v3.0 to 2026-06-06 | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-2026-06-06 |
| Migrate applications from Translator V2 to V3 | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-v3 |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Check language and feature support in Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/language-support |
| Azure Translator text and document service limits | https://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits |

### Security
| Topic | URL |
|-------|-----|
| Configure customer-managed keys for Azure Translator data at rest | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest |
| Secure Custom Translator with VNet service endpoints | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/enable-vnet-service-endpoint |
| Create SAS tokens for Document translation storage access | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens |
| Configure managed identities for Document translation storage access | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities |
| Configure Microsoft Entra ID auth for Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/microsoft-entra-id-auth |
| Secure Azure Translator access behind firewalls | https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/use-firewalls |
| Secure Azure Translator deployments in Foundry Tools | https://learn.microsoft.com/en-us/azure/ai-services/translator/secure-deployment |
| Authenticate and authorize requests to Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/authentication |

### Configuration
| Topic | URL |
|-------|-----|
| Configure Azure Translator container runtime settings | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration |
| Apply document formats and naming rules in Custom Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention |
| Configure and manage Custom Translator projects | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-project |
| Configure and manage Custom Translator workspaces | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace |
| Create and configure Azure Translator resources | https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource |
| Use Azure Translator in sovereign cloud environments | https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/sovereign-clouds |
| Use Translator 2026-06-06 translate API parameters | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/translate-api |
| Tag content to prevent translation in Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation |
| Use dynamic dictionary markup in Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary |
| Configure profanity filtering in Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering |
| Enable word alignment in Azure Translator responses | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment |
| Monitor Azure Translator usage with Azure Monitor metrics | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics |
| Use Translator V3 BreakSentence method for sentence boundaries | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence |
| Call Translator V3 detect method to identify language | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect |
| Use Translator V3 dictionary examples for contextual usage | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples |
| Use Translator V3 dictionary lookup for alternative translations | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup |
| Use Translator V3 translate method parameters | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate |
| Configure script transliteration with Translator V3 | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Deploy user-managed glossary in Translator containers | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary |
| Call Translator container document translation API | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters |
| Use Translator container text translation parameters | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters |
| Use Translator container transliteration API parameters | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters |
| Call Translator API using a Custom Translator model | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model |
| Use asynchronous batch document translation with Azure | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/asynchronous |
| Cancel an asynchronous document translation job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/cancel-translation |
| Retrieve status for all documents in a job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-documents |
| List all document translation jobs via REST | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-translations |
| Get status for a single translated document | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-document |
| Get status of a specific translation job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-translation |
| Query supported document formats for translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-document-formats |
| Query supported glossary formats for translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-glossary-formats |
| Call Azure Document Translation asynchronous REST API | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-asynchronous |
| Call Azure Translator synchronous document API | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-synchronous |
| Cancel a batch document translation job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation |
| Use Get document status in Translator Document Translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status |
| Get status for all documents in a translation job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status |
| Retrieve supported document formats via REST | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats |
| Retrieve supported glossary formats via REST | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats |
| Get status of a document translation request | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status |
| List translation jobs and statuses via REST | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status |
| Use Document Translation REST API operations | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide |
| Start batch document translation via REST | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation |
| Use synchronous text translation REST API for documents | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document |
| Integrate with adaptive custom translation (AdaptCT) API | https://learn.microsoft.com/en-us/azure/ai-services/translator/foundry/adaptive-custom-translation |
| Build document translation flows with Translator v3 connector | https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow |
| Configure text translation flows using Translator v3 connector | https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow |
| Use Azure Translator text translation REST APIs | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/rest-api-guide |
| Call Azure Translator transliterate REST method | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/transliterate-api |
| Use Azure Translator neural dictionary in apps | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary |
| Use Azure Translator REST APIs with code examples | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api |
| Integrate Azure Translator via SDK client libraries | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/client-library-sdk |
| Call Azure Translator REST API programmatically | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/rest-api |
| Translator V3 API parameters and request schema | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference |

### Deployment
| Topic | URL |
|-------|-----|
| Deploy and run Azure Translator container with Docker | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for AI and ML →

From the same set144

The whole set →
azure-sap azure-sap hands the agent a reference on SAP HANA on Azure Large Instances: deployment, HA/DR, monitoring, security. Useful when Microsoft docs are needed mid-chat. CX Codex +1 171installs azure-data-api-builder Guides agents through configuring Azure Data API Builder, exposing databases over REST or GraphQL, and setting up RLS. Useful when deploying DAB to Azure. CX Codex +1 171installs azure-managed-grafana Get guidance on configuring Azure Managed Grafana and diagnosing issues. Use the skill when working with access, plugins, private endpoints, or integrations. CX Codex +1 171installs azure-test-plans azure-test-plans is a Claude Code skill for configuring Azure Test Plans, including retention limits, custom fields, and access permissions. It also covers failure types and tcm.exe automation. CX Codex +1 171installs azure-artifact-signing An agent-side map of Azure Artifact Signing docs: SKU choice, DGSSv2 migration, certificates, RBAC, signing in CI/CD. Articles are pulled over the network. CX Codex +1 170installs azure-iot Delivers architectural guidance for Azure IoT development. Guides configuration of Device Registry namespaces, DPS, and device certificate workflows. CX Codex +1 170installs azure-health-data-services This Claude Code skill supports development with Azure Health Data Services. It comes into play for FHIR or DICOM APIs, data import and export, and related integrations. CX Codex +1 170installs azure-chaos-studio Skill for Azure Chaos Studio setup: experiments, workspaces, AKS agents, Private Link, and migration from classic experiments. CX Codex +1 170installs

Project sponsors

Companies that keep this analytics open