Skip to content
cccskills
FreePublished on GitHub

azure-microsoft-discovery

Expert knowledge for Azure Microsoft Discovery development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Discovery shared sessions, Bookshelf indexes, secure RBAC/CMK setups, REST jobs, or Docker-based tools, and other Azure Microsoft Discovery related development tasks. Not for Azure Portal (use azure-portal), Azure Resource Graph (use azure-resource-graph), Azure Monitor (use azure-monitor), Azure Cost Management (use azure-cost-management).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills
Works withAzureDocker
See how to install

Files included (1)

  • SKILL.md13.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Azure Microsoft Discovery Skill

This skill provides expert guidance for Azure Microsoft Discovery. 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

CategoryLinesDescription
TroubleshootingL37-L45Diagnosing and fixing Microsoft Discovery deployment/runtime failures, task execution issues, known bugs, and specific error codes using logs and correlation IDs.
Best PracticesL46-L52Guidance on structuring projects and shared sessions, calibrating trust levels, and applying responsible AI and safety practices when building with Microsoft Discovery.
Decision MakingL53-L60Guidance on selecting agent types, models, container registries, and understanding billing so you can design, size, and cost-optimize Microsoft Discovery solutions.
Architecture & Design PatternsL61-L65Designing and implementing advanced shared session patterns in Discovery Engine, including multi-user session management, data sharing, and scalable architecture best practices.
Limits & QuotasL66-L71Planning capacity and quota limits for Microsoft Discovery deployments, plus required naming conventions and patterns for Discovery resources in Azure.
SecurityL72-L93Security, compliance, and access control for Discovery: encryption, CMK, RBAC, managed identities, network hardening/NSGs, audit logs, and answering SIG/security posture questions.
ConfigurationL94-L112Configuring Discovery resources: storage, files, tools, data handling, Bookshelf/indexes, and querying logs (Kusto, Log Analytics, activity) for monitoring and troubleshooting
Integrations & Coding PatternsL113-L123Integrating Discovery tools/models into workflows, containerizing with Docker, running jobs via REST, and using .NET, Java, and JavaScript SDKs and action scripts.
DeploymentL124-L130Deploying Discovery across regions, provisioning supercomputer infra via REST, registering/publishing tools and container images, and managing deployment workflows in Azure.

Troubleshooting

TopicURL
Troubleshoot Discovery Engine task execution issueshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-debug-task-execution
Find Microsoft Discovery correlation IDs in Activity Loghttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-get-correlation-id
Work around known issues in Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/known-issues
Troubleshoot Microsoft Discovery deployment and runtime issueshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshoot-microsoft-discovery
Resolve Microsoft Discovery error codes and messageshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshooting-error-code

Best Practices

TopicURL
Apply project and shared session practices in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-projects-investigations
Apply responsible AI practices in Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-responsible-ai
Calibrate trust and basic shared session patterns in Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-trust-basic-investigation-patterns

Decision Making

TopicURL
Choose and configure Azure Container Registry for Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-azure-container-registry
Choose the right Microsoft Discovery agent typehttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-agent-types
Understand Microsoft Discovery billing and chargeshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-billing
Select appropriate models for Discovery agentshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-select-models-for-agents

Architecture & Design Patterns

TopicURL
Apply advanced shared session patterns with Discovery Enginehttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-advanced-investigation-patterns

Limits & Quotas

TopicURL
Plan Azure quotas for Microsoft Discovery deploymentshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-quota-reservation
Apply Microsoft Discovery resource naming ruleshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-naming

Security

TopicURL
Understand Microsoft Discovery code of conduct and acceptable usehttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-code-of-conduct
Map compliance controls for Microsoft Discovery deploymentshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-compliance-framework-mappings
Manage data encryption at rest in Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-data-encryption-at-rest
Configure managed identities for Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-managed-identities
Configure network security for Microsoft Discovery workspaceshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-network-security
Design project-level RBAC boundaries in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-project-rbac
Configure Microsoft Discovery RBAC roles and scopeshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-role-assignments
Evaluate security and compliance posture of Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-security-overview
Answer SIG-based security and compliance questions for Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/faq-security-compliance-sig
Assign Microsoft Discovery persona roles via PowerShellhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-assign-persona-roles
Configure managed identities and roles for Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-managed-identity
Configure network security for Microsoft Discovery workspaceshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-network-security
Configure project-level access and least privilegehttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-project-rbac
Configure secure networking for Discovery supercomputershttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-supercomputer-network-security
Deploy a fully network-hardened Microsoft Discovery stackhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-network-hardened-stack
Enable and export audit logs for Discovery resourceshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-enable-audit-logging
Plan NSG rules for Discovery supercomputershttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-plan-supercomputer-network-security-groups
Configure customer-managed keys for Discovery resourceshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/howto-data-encryption-at-rest

Configuration

TopicURL
Manage files and storage assets in Microsoft Discovery shared sessionshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-files-storage-assets
Register Microsoft Discovery resource provider in Azurehttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-provider-registration
Configure Azure Blob Storage for Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-storage-account
Configure storage containers and assets for Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-storage-containers-assets
Access Log Analytics workspaces for Discovery resourceshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-access-resource-logs
Author tool definition YAML for Discovery toolshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-definition
Configure data handling for tools and agents in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-data-handling-with-tools-agents
Configure Bookshelf and index knowledgebases in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-index-bookshelf-knowledgebase
Configure storage containers and assets in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-storage-containers
Query bookshelf indexing logs in Discovery supercomputershttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-indexing-logs
Query bookshelf knowledgebase query logs in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-logs
Query CogLoop orchestration logs for Discovery investigationshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-cognitive-loop-logs
Query supercomputer platform and tool logs in Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-supercomputer-logs
Query Discovery workspace logs with Kusto and correlation IDshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-workspace-logs
View Azure activity logs for Discovery control planehttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-view-activity-logs

Integrations & Coding Patterns

TopicURL
Integrate tools and models into Microsoft Discovery workflowshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-tools-model-integration
Create Dockerfiles to containerize Discovery toolshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-docker-file
Use Discovery Supercomputer REST APIs for job runshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-run-jobs-supercomputer-rest-api
Implement action scripts for Discovery action-based toolshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-write-tool-action-scripts
Use .NET SDK packages for Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-dotnet-sdks
Use Java SDK artifacts for Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-java-sdks
Use JavaScript SDK packages for Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-javascript-sdks

Deployment

TopicURL
Deploy Microsoft Discovery across Azure regionshttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-across-regions
Deploy and register tools to Microsoft Discoveryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-tool-to-discovery
Provision Discovery Supercomputer infrastructure via REST APIhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-supercomputers-rest-api
Publish Discovery tool images to Azure Container Registryhttps://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-publish-tool-to-acr

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts/digests, managing rec states, using workbooks, Resource Graph, or RBAC for access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing AKS Edge/Hybrid with Arc, GitOps, IoT/OPC/ONVIF, TPM/Key Vault secrets, or AI model workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-anomaly-detector

Free

Expert knowledge for Azure AI Anomaly Detector development including troubleshooting, best practices, limits & quotas, configuration, and deployment. Use when tuning Docker-based Anomaly Detector, ACI or IoT Edge deployments, univariate/multivariate APIs, or service limits, and other Azure AI Anomaly Detector related development tasks. Not for Azure AI Metrics Advisor (use azure-metrics-advisor), Azure Monitor (use azure-monitor), Azure Machine Learning (use azure-machine-learning).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

See all skills by MicrosoftDocs

Report a problem with this skill