Skip to main content
skill CX Codex

azure-document-intelligence — Claude Code skill: what it does

The azure-document-intelligence skill guides Azure AI Document Intelligence development, from model selection and API troubleshooting to v4.0 migration. It fetches reference material over the network.

CC-BY-4.0 223 installs ★ 818 updated 2026-10-25

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

What azure-document-intelligence does

The skill gives an agent guidance for Azure AI Document Intelligence tasks, including model choice, cost estimates, security, integrations, and deployment. A local category index points to relevant material; the agent can retrieve further documentation with mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage.

Use it when working with AnalyzeDocument APIs, custom models, or batch analysis. It also covers containers and migration to v4.0. Network access is required to fetch remote documentation, so the guidance cannot be retrieved offline.

What it helps with

  • choose an Azure AI Document Intelligence model
  • investigate API errors and latency issues
  • plan a migration to v4.0
  • configure secure access to a resource
  • prepare a container deployment

Example prompts for the agent

  • Help me choose an Azure AI Document Intelligence model for my documents.
  • Investigate this AnalyzeDocument API error and find relevant guidance.
  • Plan a migration of my project to Azure AI Document Intelligence v4.0.

How to install azure-document-intelligence

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/azure-document-intelligence/SKILL.md

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

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

Questions about azure-document-intelligence

How do I install azure-document-intelligence in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-document-intelligence -a claude-code. The skill file is located at ~/.claude/skills/azure-document-intelligence/SKILL.md.

What does azure-document-intelligence do?

It guides an agent through Azure AI Document Intelligence development, including APIs, models, security, configuration, and deployment. The agent can fetch related documentation as needed.

Does azure-document-intelligence need network access?

Yes. It retrieves documentation with mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage, so network access is needed for those requests.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-document-intelligence
description: Expert knowledge for Azure AI Document Intelligence development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using AnalyzeDocument APIs, custom/classification/template models, batch analysis, containers, or v4.0 migration, and other Azure AI Document Intelligence related development tasks. Not for Azure AI Vision (use azure-ai-vision), Azure AI Custom Vision (use azure-custom-vision), Azure AI Search (use azure-cognitive-search), Azure AI Video Indexer (use azure-video-indexer).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-10-25"
  generator: "docs2skills/1.0.0"
---
# Azure AI Document Intelligence Skill

This skill provides expert guidance for Azure AI Document Intelligence. 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-L42 | Diagnosing latency, understanding and fixing Document Intelligence API error codes, and handling known service issues and limitations. |
| Best Practices | L43-L54 | Guidance on designing, training, labeling, composing, and maintaining custom/classification/template models to maximize Document Intelligence accuracy and confidence |
| Decision Making | L55-L61 | Choosing the right Document Intelligence model, estimating and optimizing usage/costs, and planning or executing migration to v4.0 from earlier versions. |
| Limits & Quotas | L62-L72 | Docs on capacity limits, quotas, supported languages/locales, scaling with batch analysis and add-ons, and container image tags for deploying Azure Document Intelligence at different tiers. |
| Security | L73-L80 | Securing Document Intelligence resources: creating SAS tokens, configuring data-at-rest encryption with customer-managed keys, and using managed identities and VNETs for secure access. |
| Configuration | L81-L85 | How to configure and run Azure Document Intelligence in containers, including environment settings, networking, storage, licensing, and deployment options for on-premises or hybrid scenarios. |
| Integrations & Coding Patterns | L86-L95 | Using Document Intelligence APIs/SDKs, interpreting AnalyzeDocument/Markdown outputs, and integrating with Azure Functions or Logic Apps for end-to-end document processing workflows |
| Deployment | L96-L102 | Running Document Intelligence in Docker/offline, deploying the labeling tool, and setting up resilient, disaster‑ready deployments for models and services |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Troubleshoot Azure Document Intelligence latency issues | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/troubleshoot-latency?view=doc-intel-4.0.0 |
| Reference and resolve Document Intelligence API errors | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/resolve-errors?view=doc-intel-4.0.0 |
| Handle known issues in Azure Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/reference/known-issues?view=doc-intel-4.0.0 |

### Best Practices
| Topic | URL |
|-------|-----|
| Improve Document Intelligence accuracy and confidence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/accuracy-confidence?view=doc-intel-4.0.0 |
| Train custom document classification models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/build-a-custom-classifier?view=doc-intel-4.0.0 |
| Build and train Document Intelligence custom models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/build-a-custom-model?view=doc-intel-4.0.0 |
| Create and compose Document Intelligence custom models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/compose-custom-models?view=doc-intel-4.0.0 |
| Apply labeling best practices in Document Intelligence Studio | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/train/custom-label-tips?view=doc-intel-4.0.0 |
| Apply labeling best practices for high-accuracy custom models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/train/custom-labels?view=doc-intel-4.0.0 |
| Manage Document Intelligence custom model lifecycle | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/train/custom-lifecycle?view=doc-intel-4.0.0 |
| Train template models with supervised table tags | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/v21/supervised-table-tags?view=doc-intel-2.1.0 |

### Decision Making
| Topic | URL |
|-------|-----|
| Select the right Azure Document Intelligence model | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/choose-model-feature?view=doc-intel-4.0.0 |
| Estimate Document Intelligence usage and cost | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/estimate-cost?view=doc-intel-4.0.0 |
| Decide and migrate to Document Intelligence v4.0 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/versioning/migration-guide-overview?view=doc-intel-4.0.0 |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Increase Document Intelligence capacity with add-ons | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/add-on-capabilities?view=doc-intel-4.0.0 |
| Reference Document Intelligence container image tags | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/image-tags?view=doc-intel-4.0.0 |
| Azure Document Intelligence quotas and usage limits FAQ | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/faq?view=doc-intel-4.0.0 |
| Check OCR language and locale support for Read/Layout | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/language-support/ocr?view=doc-intel-4.0.0 |
| Review language support for Document Intelligence prebuilt models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/language-support/prebuilt?view=doc-intel-4.0.0 |
| Use Document Intelligence batch analysis at scale | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/prebuilt/batch-analysis?view=doc-intel-4.0.0 |
| Apply Document Intelligence quotas and limits by tier | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/service-limits?view=doc-intel-4.0.0 |

### Security
| Topic | URL |
|-------|-----|
| Create SAS tokens for Document Intelligence storage | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/create-sas-tokens?view=doc-intel-4.0.0 |
| Manage data-at-rest encryption and CMK for Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/encrypt-data-at-rest?view=doc-intel-4.0.0 |
| Secure Document Intelligence with managed identities and VNETs | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/managed-identities-secured-access?view=doc-intel-4.0.0 |
| Configure managed identities for Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/managed-identities?view=doc-intel-4.0.0 |

### Configuration
| Topic | URL |
|-------|-----|
| Configure Azure Document Intelligence containers | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/configuration?view=doc-intel-4.0.0 |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Use AnalyzeDocument API response objects effectively | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/analyze-document-response?view=doc-intel-4.0.0 |
| Consume Document Intelligence Markdown output | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/markdown-elements?view=doc-intel-4.0.0 |
| Integrate Document Intelligence via SDKs and REST | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/use-sdk-rest-api?view=doc-intel-4.0.0 |
| Use Document Intelligence SDKs and REST APIs | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/quickstarts/get-started-sdks-rest-api?view=doc-intel-4.0.0 |
| Process documents with Azure Functions and Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/tutorial/azure-function?view=doc-intel-4.0.0 |
| Integrate Document Intelligence with Azure Logic Apps | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/tutorial/logic-apps?view=doc-intel-4.0.0 |

### Deployment
| Topic | URL |
|-------|-----|
| Run Document Intelligence containers offline | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/disconnected?view=doc-intel-4.0.0 |
| Install and run Document Intelligence Docker containers | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/install-run?view=doc-intel-4.0.0 |
| Implement disaster recovery for Document Intelligence models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/disaster-recovery?view=doc-intel-4.0.0 |
| Deploy the Document Intelligence Sample Labeling tool | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/v21/deploy-label-tool?view=doc-intel-2.1.0 |

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-boards Covers Azure Boards work items, WIQL, permissions, limits, and integrations. It fetches Microsoft documentation for focused answers. CX Codex +1 242installs azure-cognitive-search The azure-cognitive-search Claude Code skill supports Azure AI Search development. It covers index configuration, vector and semantic search, security, and deployment. CX Codex +1 232installs azure-api-management azure-api-management is a Claude Code skill for Azure API Management development. It activates for gateway and policy configuration, OAuth security, or AI backend integrations. CX Codex +1 232installs azure-policy Skill for Azure Policy development across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 225installs azure-cost-management azure-cost-management — a skill for Claude Code and Cursor that guides Azure billing API integration, budget alerts, and cost exports. Resolves billing discrepancies and reservation issues. CX Codex +1 222installs azure-cache-redis The azure-cache-redis skill guides Azure Cache for Redis work, from connection failures and tier choices to security, configuration, and deployment. CX Codex +1 218installs azure-virtual-network A skill bundling Microsoft documentation on Azure Virtual Network design, configuration, and operations. Covers subnets, routing, NSGs, peering, and network security across best practices and deployment patterns. CX Codex +1 217installs microsoft-foundry-local Skill for Claude Code, Codex, Cursor and other IDEs with expert guidance on Microsoft Foundry Local development. Covers CLI setup, Hugging Face model compilation via Olive, embeddings, chat, audio transcription, and function calling. CX Codex +1 214installs

Project sponsors

Companies that keep this analytics open