Azure Digital Twins Skill

This skill provides expert guidance for Azure Digital Twins. Covers troubleshooting, best practices, decision making, architecture & design patterns, 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

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	L37-L46	Diagnosing and fixing common Azure Digital Twins issues: 403/404 errors, Explorer auth problems, CLI parse failures, known bugs, and performance troubleshooting.
Best Practices	L47-L53	Guidance on modeling best practices: converting RDF/OWL ontologies to DTDL, extending DTDL for Azure Digital Twins, and designing effective tagging patterns for twin graphs.
Decision Making	L54-L59	Guidance on selecting DTDL-based industry ontologies for your twin models and instructions for migrating from Azure Digital Twins preview control plane APIs to current APIs.
Architecture & Design Patterns	L60-L65	Patterns for routing data into/out of Azure Digital Twins, plus strategies for high availability, redundancy, and disaster recovery planning and configuration.
Limits & Quotas	L66-L71	Details on Azure Digital Twins query unit usage, plus service limits, throttling behavior, and how to view/request changes to adjustable quotas.
Security	L72-L80	Security guidance for Azure Digital Twins: auth with Entra app registrations, client authentication, Private Link setup, and handling customer personal data and best practices.
Configuration	L81-L105	Configuring and operating Azure Digital Twins: instance setup, security, endpoints/routes, data history, monitoring, graph/twin/model management, Explorer/3D tools, and query language usage.
Integrations & Coding Patterns	L106-L122	APIs, SDKs, CLI, and query usage; integrating IoT Hub, Azure Data Explorer, Functions, Power Platform; coding .NET clients and validating DTDL models for Azure Digital Twins.
Deployment	L123-L126	Guidance for moving an Azure Digital Twins instance to a different region, including prerequisites, supported scenarios, and step-by-step migration procedures.

Troubleshooting

Topic	URL
Fix Azure Digital Twins 403 Forbidden errors	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-403-digital-twins
Fix Azure Digital Twins 404 sub-domain not found errors	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-404-digital-twins
Resolve Azure Digital Twins Explorer authentication errors	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-azure-digital-twins-explorer-authentication
Resolve Azure Digital Twins CLI parse failed errors	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-cli-parse
Resolve known issues in Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-known-issues
Troubleshoot Azure Digital Twins performance issues	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-performance

Best Practices

Topic	URL
Convert RDF/OWL ontologies to DTDL models	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-convert
Extend DTDL ontologies for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-extend
Implement tagging patterns for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-tags

Decision Making

Topic	URL
Choose DTDL-based industry ontologies for Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-adopt
Migrate from Azure Digital Twins preview control plane APIs	https://learn.microsoft.com/en-us/azure/digital-twins/resources-migrate-from-preview-apis

Architecture & Design Patterns

Topic	URL
Design data ingress and egress for Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-ingress-egress
Plan high availability and disaster recovery for Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-high-availability-disaster-recovery

Limits & Quotas

Topic	URL
Understand Query Unit consumption in Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-units
Azure Digital Twins service limits and adjustable quotas	https://learn.microsoft.com/en-us/azure/digital-twins/reference-service-limits

Security

Topic	URL
Apply security best practices to Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-security
Implement client authentication for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-authenticate-client
Create Entra app registration for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-app-registration
Enable Private Link for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-enable-private-link
Handle customer personal data in Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/resources-customer-data-requests

Configuration

Topic	URL
Interpret Azure Digital Twins event notifications	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-event-notifications
Configure endpoints and event routes in Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-route-events
Set up Azure Digital Twins data history connection	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-data-history-connection
Configure Azure Digital Twins event endpoints	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-endpoints
Configure event routes and filters in Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-routes
Manage Azure Digital Twins graphs and relationships	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-graph
Manage DTDL models in Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-model
Manage individual digital twins via APIs/SDKs	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-twin
Configure monitoring, metrics, and logs for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-monitor
Provision and secure Digital Twins via CLI	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-set-up-instance-cli
Set up an Azure Digital Twins instance in portal	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-set-up-instance-portal
Use 3D Scenes Studio features with Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-3d-scenes-studio
Operate Azure Digital Twins Explorer features	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-azure-digital-twins-explorer
Use FROM clause in Azure Digital Twins query language	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-from
Use JOIN clause in Azure Digital Twins graph queries	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-join
Use MATCH clause for graph traversal in Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-match
Use SELECT clause in Azure Digital Twins query language	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-select
Use WHERE clause in Azure Digital Twins queries	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-where
Use functions in Azure Digital Twins query language	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-functions
Use operators in Azure Digital Twins query language	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-operators
Reserved keywords in Azure Digital Twins query language	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-reserved

Integrations & Coding Patterns

Topic	URL
Work with Azure Digital Twins APIs and SDKs	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-apis-sdks
Use Azure Digital Twins CLI command set	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli
Query Digital Twins via Azure Data Explorer plugin	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-explorer-plugin
Configure data history with Azure Data Explorer	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-history
Use Azure Digital Twins query language	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-language
Ingest IoT Hub telemetry into Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-ingest-iot-hub-data
Parse and validate DTDL models with .NET	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-parse-models
Query Azure Digital Twins graphs with examples	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-query-graph
Set up twin-to-twin event propagation with Azure Functions	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-send-twin-to-twin-events
Call Azure Digital Twins REST APIs using .http files	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-apis
Use Power Platform connector with Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-power-platform-logic-apps-connector
Code a .NET client for Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/tutorial-code
Use Azure CLI commands with Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/tutorial-command-line-cli

Deployment

Topic	URL
Move an Azure Digital Twins instance across regions	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-move-regions

Files1

1 files · 18.2 KB

Select a file to preview

Overall Score

88/100

Grade

A

Excellent

Safety

92

Quality

87

Clarity

89

Completeness

82

Summary

This skill provides expert guidance for Azure Digital Twins development, covering troubleshooting, best practices, architecture patterns, security, configuration, integrations, and deployment. It functions as a curated reference index that directs agents to Microsoft Learn documentation using either mcp_microsoftdocs tools or fetch_webpage, with clear categorization and scope boundaries.

Detected Capabilities

documentation fetchnetwork access to learn.microsoft.commcp_microsoftdocs integrationwebpage fetch with markdown returnreference guidance (read-only)

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure digital twinsdtdl modelingtwin graph querydigital twins troubleshootazure twins architecturetwins security setupiot hub integrationtwins deployment

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

/Troubleshoot 403/404 authentication and API errors in Azure Digital Twins
Design DTDL models following best practices and industry ontologies
Plan high-availability and disaster-recovery architecture for digital twins
Integrate IoT Hub, Azure Functions, or Azure Data Explorer with Azure Digital Twins
Configure security, Private Link, Entra authentication, and monitoring
Query twin graphs using DTDL query language with examples
Migrate from preview control plane APIs to current APIs
Set up and manage Azure Digital Twins instances via portal or CLI

Quality Notes

Excellent use of Category Index with line ranges for fast agent navigation
Clear skill scope with explicit boundaries (not for IoT Hub, IoT Central, IoT Edge, IoT Operations)
Network requirements transparently documented with preferred and fallback methods
Well-organized reference structure with 8 major categories and 40+ curated links
Metadata field helps agents detect when skill documentation is stale (3-month check)
Metadata indicates skill was auto-generated from docs (docs2skills/1.0.0) — transparent provenance
All external links point to learn.microsoft.com, reducing dependency fragmentation
Clear guidance for agents on tool availability (mcp_microsoftdocs with fallback)
Comprehensive coverage of Azure Digital Twins domain with no detectable gaps in major topics

Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

azure-digital-twins