SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-microsoft-discovery

MicrosoftDocs

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 workspaces, shared sessions, supercomputer jobs, Docker tools, or Log Analytics queries, and other Azure Microsoft Discovery related development tasks. Not for Azure Resource Graph (use azure-resource-graph), Azure Portal (use azure-portal), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy).

globalRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
generated_at:2026-06-14
generator:docs2skills/1.0.0
New~2.9k
v1.0Saved Jun 26, 2026

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

Category Lines Description
Troubleshooting L37-L41 Diagnosing and fixing Discovery Engine task execution failures, including common error patterns, configuration issues, and steps to restore successful task runs.
Best Practices L42-L49 Best practices for structuring projects and shared sessions, applying responsible AI, calibrating trust and safety patterns, and planning tool capabilities and compute for Discovery.
Decision Making L50-L57 Guidance on selecting registries, agent types, billing options, and LLM models for Microsoft Discovery, including configuration, cost implications, and matching models/agents to workloads.
Architecture & Design Patterns L58-L62 Designing and implementing advanced shared session patterns in Discovery Engine, including multi-user session management, data sharing, and scalable architecture best practices.
Limits & Quotas L63-L68 Planning capacity and Azure quotas for Microsoft Discovery deployments, plus required naming conventions and rules for Discovery resources.
Security L69-L82 Security and compliance for Discovery: encryption at rest, customer-managed keys, managed identities, RBAC/persona roles, network/private access, and audit logging configuration.
Configuration L83-L103 Configuring Discovery workspaces, supercomputers, storage, tools, data handling, and querying operational/indexing logs via Log Analytics and Kusto.
Integrations & Coding Patterns L104-L111 Patterns and APIs for integrating tools/models into Discovery workflows, containerizing tools with Docker, writing action scripts, and submitting/monitoring Supercomputer jobs via REST
Deployment L112-L118 Deploying Microsoft Discovery: secure stack setup, provisioning supercomputer infra via REST, registering tools, and publishing tool images to Azure Container Registry.

Troubleshooting

Topic URL
Troubleshoot Discovery Engine task execution issues https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-debug-task-execution

Best Practices

Topic URL
Apply projects and shared session best practices in Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-projects-investigations
Apply responsible AI practices in Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-responsible-ai
Calibrate trust and basic shared session patterns in Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-trust-basic-investigation-patterns
Plan tool functionality and compute for Discovery tools https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-plan-tool-requirements

Decision Making

Topic URL
Choose and configure Azure Container Registry for Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-azure-container-registry
Choose appropriate agent types in Microsoft Discovery and Discovery app https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-agent-types
Understand Microsoft Discovery billing and charges https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-billing
Choose appropriate LLM models for Discovery agents https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-select-models-for-agents

Architecture & Design Patterns

Topic URL
Apply advanced shared session patterns with Discovery Engine https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-advanced-investigation-patterns

Limits & Quotas

Topic URL
Plan Azure quotas and capacity for Microsoft Discovery deployments https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-quota-reservation
Apply Microsoft Discovery resource naming rules https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-naming

Security

Topic URL
Understand Microsoft Discovery code of conduct and acceptable use https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-code-of-conduct
Manage data encryption at rest in Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-data-encryption-at-rest
Configure managed identities for Microsoft Discovery resources https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-managed-identities
Configure network security for Microsoft Discovery workspaces https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-network-security
Configure RBAC role assignments for Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-role-assignments
Assign Microsoft Discovery persona RBAC roles via PowerShell https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-assign-persona-roles
Configure user-assigned managed identities for Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-managed-identity
Configure network security and private access for Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-network-security
Enable and export audit logs for Discovery resources https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-enable-audit-logging
Configure customer-managed keys for Discovery resources https://learn.microsoft.com/en-us/azure/microsoft-discovery/howto-data-encryption-at-rest

Configuration

Topic URL
Manage files and storage assets in Microsoft Discovery shared sessions https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-files-storage-assets
Register Microsoft Discovery resource provider in Azure https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-provider-registration
Configure Azure Blob Storage for Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-storage-account
Configure storage containers and assets for Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-storage-containers-assets
Access Log Analytics workspaces for Discovery resources https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-access-resource-logs
Author tool definition YAML for Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-definition
Configure data handling for Microsoft Discovery agents https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-data-handling-with-tools-agents
Configure Bookshelf and index knowledgebases in Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-index-bookshelf-knowledgebase
Configure storage containers and assets in Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-storage-containers
Create and manage Discovery Supercomputers and node pools https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-supercomputers
Create and manage Microsoft Discovery workspaces https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-workspaces
Query bookshelf indexing logs in Discovery supercomputers https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-indexing-logs
Query bookshelf knowledgebase query logs in Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-logs
Query CogLoop orchestration logs for Discovery investigations https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-cognitive-loop-logs
Query supercomputer platform and tool logs in Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-supercomputer-logs
Query Discovery workspace logs with Kusto and correlation IDs https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-workspace-logs
View Azure activity logs for Discovery control plane https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-view-activity-logs

Integrations & Coding Patterns

Topic URL
Integrate tools and models into Microsoft Discovery workflows https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-tools-model-integration
Create Dockerfiles to containerize Discovery tools https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-docker-file
Submit and monitor Discovery Supercomputer jobs with REST APIs https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-run-jobs-supercomputer-rest-api
Implement action scripts for Discovery action-based tools https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-write-tool-action-scripts

Deployment

Topic URL
Deploy a fully network-hardened Microsoft Discovery stack https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-network-hardened-stack
Deploy and register tools to Microsoft Discovery https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-tool-to-discovery
Provision Discovery Supercomputer infrastructure via REST API https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-supercomputers-rest-api
Publish Discovery tool images to Azure Container Registry https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-publish-tool-to-acr
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

78/100

Grade

B

Good

Safety

88

Quality

75

Clarity

82

Completeness

68

Summary

This skill is a reference guide for Azure Microsoft Discovery development, providing expert guidance on troubleshooting, best practices, architecture, security, configuration, integrations, and deployment. It is primarily a knowledge aggregation skill that directs agents to fetch remote documentation via Microsoft Docs or fallback webpage tools, with a well-organized category index covering 9 major topic areas (36 total documentation links). The skill requires network access but performs no destructive operations, credential access, or file modifications.

Detected Capabilities

network accessremote documentation fetchexternal webpage retrievalknowledge indexing and reference

Trigger Keywords

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

azure discovery workspacediscovery supercomputerdiscovery security setupdiscovery tool integrationdiscovery troubleshootingdiscovery kusto queriesdiscovery deployment

Risk Signals

INFO

Network access requirement via mcp_microsoftdocs and fetch_webpage

compatibility field and 'How to Use' section
INFO

External URL references to learn.microsoft.com

Category index and all reference tables (L35-L118)
INFO

Fallback to fetch_webpage with query parameters

'How to Use' section, fallback instructions

Referenced Domains

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

github.comlearn.microsoft.com

Use Cases

  • Building Azure Discovery workspaces
  • Configuring supercomputer jobs and nodes
  • Setting up Security and RBAC in Discovery
  • Integrating custom tools into Discovery workflows
  • Deploying network-hardened Discovery stacks
  • Troubleshooting Discovery Engine task execution
  • Querying Discovery logs via Log Analytics and Kusto

Quality Notes

  • Excellent category index with clear line ranges and descriptions, enabling precise targeted queries
  • Well-organized reference tables for each category with direct learn.microsoft.com URLs
  • Clear usage instructions for agents, including MCP tool preference ordering and fallback strategy
  • Proactive metadata aging check (3-month threshold) prompts users to update skill
  • Comprehensive coverage spanning 9 major topic areas with 36 documentation links
  • Skill clearly documents what it is NOT (Resource Graph, Portal, Monitor, Policy) to avoid scope creep
  • No executable code, no file writes, no credential access—purely informational
  • Limitation: references local content sections (L35-L120) that are not included in the skill file itself; this appears to be auto-generated documentation structure that may not be fully self-contained
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.

Add MicrosoftDocs/azure-microsoft-discovery to your library

Get Started Free

Command Palette

Search for a command to run...