Dev & Engineering ✓ Microsoft · Official document-intelligencetypescriptazure-sdkocrinvoice-extractiontable-extractioncustom-models

Azure Document Intelligence for TypeScript

Extract document text, tables, and structured fields in TypeScript applications.

FollowSkills review · FSRS-2.0
Not recommended
50/ 100 5-point scale 2.5 / 5
Trust15 / 25 · 3.0/5

The skill exposes the data flows for API keys, DefaultAzureCredential, managed identity, endpoints, document URLs, and training-data SAS URLs, and it recommends managed identity; no credential theft, covert exfiltration, or destructive default is evident. However, it does not state that secrets must not be hard-coded, explain handling or retention for potentially sensitive personal documents, or provide confirmation, least-privilege, rollback, or external-impact controls, so points are deducted.

Reliability8 / 20 · 2.0/5

Installation, authentication, analysis, polling, pagination, and error-checking patterns are broadly coherent, with isUnexpected and long-running polling used repeatedly. Still, the supplied material contains no skill-specific tests or reproducible results; some examples such as receipt analysis omit error checking, and empty results, timeouts, service errors, version drift, and input validation are not covered. Under the static ceiling, the score cannot exceed 10, so points are deducted.

Adaptability9 / 15 · 3.0/5

The name, description, and examples clearly target TypeScript users and cover invoices, receipts, IDs, forms, URL/local-file inputs, custom models, and classification. Boundaries for non-fit cases, service-version requirements, input/output contracts, semantic triggers, and Chinese-language support are not stated. The core function also depends on Azure services, with no mainland-China reachability or regional limitation guidance, so points are deducted.

Convention8 / 15 · 2.7/5

The SKILL.md is readable and progressively organized around installation, authentication, task examples, models, polling, types, and best practices. It includes MIT licensing, Microsoft authorship, version 1.0.0, and the package name in metadata. It lacks a pinned SDK/API version, changelog, explicit maintenance owner and update path, FAQ, troubleshooting, known limitations, and complete prerequisites, so points are deducted.

Effectiveness6 / 15 · 2.0/5

The examples are directly reusable TypeScript starting points and cover common prebuilt models, URL/file input, custom models, classification, and pagination, providing clear value over starting manually. However, no executed evidence is supplied; output shapes and service-version compatibility are unverified, while secure document handling, retries, timeouts, confidence thresholds, and production integration remain for the user to add. Under the static ceiling, the score cannot exceed 7, so points are deducted.

Verifiability4 / 10 · 2.0/5

The skill provides auditable code, package names, environment variables, and one official documentation reference; the repository materials also show generic CI and test infrastructure. They do not provide skill-specific tests, execution logs, pinned versions, or independent corroboration, and this review did not execute the code. Under the static ceiling, the score cannot exceed 5, so points are deducted.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 9ccaf7c3704a
Before you use it
  • Do not hard-code or log API keys, SAS URLs, or document contents; prefer least-privilege managed identity and add rotation, retention, and access controls for production.
  • Before adoption, verify paths, model IDs, output fields, and polling behavior against the current @azure-rest/ai-document-intelligence version, and add handling for timeouts, retries, empty results, and sensitive documents.
  • The skill does not address mainland-China reachability, Azure regional restrictions, or Chinese locale/documentation support; verify these separately before deployment.
See the full review method →

What it does & when to use it

This skill shows developers how to use the Azure Document Intelligence REST SDK for TypeScript to process documents. It covers OCR, layout, invoice, receipt, and identity-document prebuilt models, along with custom models and document classifiers. Authentication examples use either API keys or DefaultAzureCredential. Because analysis is asynchronous, the examples rely on long-running pollers, making the skill suitable for Node.js teams integrating document processing into applications.

Installs @azure-rest/ai-document-intelligence and @azure/identity, creates a DocumentIntelligence REST client, submits analysis requests from URLs or Base64-encoded local files, polls asynchronous operations, and reads text, tables, pages, fields, and related confidence information. It also demonstrates invoice and receipt field extraction, paginated model listing, custom model building, classifier building and classification, and service-information queries.

  1. A TypeScript developer extracting vendor names, totals, and due dates from invoices.
  2. A business application team processing receipts and their merchant, total, and line-item fields.
  3. An engineering team extracting text, tables, and selection marks from forms or layout-heavy PDFs.
  4. A developer building a custom purchase-order model from Azure Blob training data.
  5. An application that classifies incoming documents before routing them to different workflows.

Pros & cons

Pros
  • Provides both URL and local-file input patterns.
  • Covers text, tables, invoices, receipts, IDs, custom models, and classifiers.
  • Shows both DefaultAzureCredential and API-key authentication.
  • Includes error checking, asynchronous polling, progress monitoring, and pagination.
Limitations
  • Requires an Azure Document Intelligence resource, endpoint, and credentials.
  • Document analysis is asynchronous, so callers must handle polling.
  • Custom model and classifier examples require an Azure Blob SAS URL and training data.
  • Does not include pricing, resource provisioning, or permission setup guidance.

How to install

Run npx skills add microsoft/skills and select this skill in the installation wizard. The README says skills are installed in the selected agent directory, such as .github/skills/ for GitHub Copilot, and can be shared across agents with symlinks. Install the application packages with npm install @azure-rest/ai-document-intelligence @azure/identity. The source does not document Azure resource provisioning or pricing.

How to use

After installation, ask an coding Agent something like: "Use the Azure Document Intelligence TypeScript REST SDK to extract VendorName, InvoiceTotal, and DueDate from an invoice URL, using DefaultAzureCredential, long-running polling, and error handling." Configure DOCUMENT_INTELLIGENCE_ENDPOINT, plus either DOCUMENT_INTELLIGENCE_API_KEY or AZURE_TOKEN_CREDENTIALS=prod depending on the authentication method. Submit the analysis, check errors with isUnexpected(), and wait for completion with getLongRunningPoller().

Compared to similar skills

The skill distinguishes prebuilt models from custom models and presents API-key and DefaultAzureCredential authentication paths. It does not compare other SDKs or competing services.

FAQ

Can it process a local PDF?
Yes. The example reads a local file with `node:fs/promises`, converts it to Base64, and submits it for analysis.
Is an API key required?
No. The skill also documents DefaultAzureCredential; production use of that credential requires `AZURE_TOKEN_CREDENTIALS`.
Can I train a custom document model?
Yes. The examples build template or neural custom models from Azure Blob data and also build document classifiers.
Does it explain Azure setup and cost?
No. The supplied material covers SDK installation, environment variables, authentication, and API usage, but not provisioning or pricing.

More skills from this repository

All from microsoft/agent-skills

Dev & Engineering ✓ Microsoft · Official

Azure Identity for Python

A practical skill for securing Python Azure applications with Microsoft Entra ID credentials.

Dev & Engineering ✓ Microsoft · Official

Azure Event Hubs Java Skill

Build production-oriented Java event streaming applications on Azure Event Hubs.

Dev & Engineering ✓ Microsoft · Official

Azure Tables for Python

A practical guide to building authenticated Azure Tables applications with Python entity CRUD, queries, and partition-scoped batch operations.

Dev & Engineering ✓ Microsoft · Official

Azure Identity for TypeScript

Configure secure, flexible Microsoft Entra ID authentication for TypeScript Azure applications.

Automation & Ops ✓ Microsoft · Official

Azure Reliability Advisor

Assess and improve reliability for Azure Functions and App Service.

Dev & Engineering ✓ Microsoft · Official

Azure Cloud Architect

Guides coding agents through production-grade Azure architecture design and review using Azure Architecture Center practices.

Dev & Engineering ✓ Microsoft · Official

Azure AI Text Analytics for Python

Guides Python developers through Azure-powered text analysis and NLP workflows.

Automation & Ops ✓ Microsoft · Official

Azure Resource Architecture Visualizer

Analyze Azure resource groups and turn their dependencies into detailed Mermaid architecture diagrams.

Dev & Engineering ✓ Microsoft · Official

Azure Maps for .NET

Build .NET location features for search, routing, maps, geolocation, and weather.

Dev & Engineering ✓ Microsoft · Official

Azure AI Vision Image Analysis

Guides Python coding agents in implementing Azure AI Vision image understanding.

Dev & Engineering ✓ Microsoft · Official

Azure Blob Storage for Python

Guides secure, production-minded Blob Storage operations in Python.

Dev & Engineering ✓ Microsoft · Official

Azure Queue Storage for Python

Gives coding agents reliable Python patterns for secure Azure Queue Storage messaging and asynchronous task processing.

Automation & Ops ✓ Microsoft · Official

Azure AI Gateway Governance

Use Azure API Management to govern traffic across AI models, MCP tools, and agents.

Automation & Ops ✓ Microsoft · Official

AKS Automatic Readiness

Assess Kubernetes workloads for AKS Automatic compatibility and identify migration blockers before you switch.

Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB ARM for .NET

Provision and manage Azure Cosmos DB resources from .NET through ARM.

Dev & Engineering ✓ Microsoft · Official

Azure Playwright Workspace Manager

Provision and manage Microsoft Playwright Testing workspaces with .NET and Azure Resource Manager.

Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB for Python

A practical guide for building reliable Python applications on Azure Cosmos DB’s NoSQL API.

Dev & Engineering ✓ Microsoft · Official

Azure Key Vault SDK for Python

Gives Python coding agents practical guidance for securely managing Azure Key Vault secrets, keys, and certificates.

Dev & Engineering ✓ Microsoft · Official

Azure API Management for Python

Gives coding agents practical Python SDK patterns for managing Azure API Management services, APIs, products, subscriptions, and policies.

Dev & Engineering ✓ Microsoft · Official

Azure Monitor Query for Python

Generate Python code for querying Azure Monitor logs and metrics.

Related skills