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 designing shared sessions, RBAC/managed identity, supercomputer jobs, Bookshelf KBs, or Docker/SDK integrations, and other Azure Microsoft Discovery related development tasks.
How do I install this agent skill?
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-microsoft-discoveryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a directory of official Microsoft documentation links for Azure Microsoft Discovery development. It directs the AI agent to fetch content from trusted Microsoft domains and GitHub repositories.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L48 | Diagnosing and fixing Discovery engine, onboarding, deployment/runtime failures, using logs/correlation IDs, CogLoop/bookshelf query debugging, and known error codes/issues. |
| Best Practices | L49-L54 | Guidance on responsible AI usage in Microsoft Discovery and rules for naming Discovery resources consistently and correctly. |
| Decision Making | L55-L63 | Guidance on planning Discovery deployments: choosing architectures, agent types, network modes/routing, fixed settings, and selecting suitable models for different use cases. |
| Architecture & Design Patterns | L64-L69 | Designing shared session architectures in Discovery Engine, including trust models, basic vs advanced patterns, and how to structure multi-user or multi-app session data. |
| Limits & Quotas | L70-L74 | Managing Discovery deployment quotas and capacity reservations, including limits, scaling behavior, and how to plan or adjust resources for different workloads. |
| Security | L75-L97 | Security, compliance, and access control for Discovery: RBAC design, managed identities, encryption/CMK, network/NSG/UDR setup, STRIDE threat mapping, audit logs, and SIG/security questionnaire support. |
| Configuration | L98-L118 | Configuring Discovery infrastructure: storage, registries, workspaces, supercomputers, data handling, onboarding/DryRun, and querying logs/reports for tools and Bookshelf knowledge bases. |
| Integrations & Coding Patterns | L119-L130 | Integrating Discovery tools/models into workflows, containerizing with Docker, using REST APIs for Supercomputers/jobs, and coding with .NET, Java, and JavaScript SDKs. |
| Deployment | L131-L139 | Guides for deploying Discovery on Azure: landing zone prep, multi-region and hardened setups, AKS upgrade behavior, onboarding tooling, and publishing container images to ACR. |
Troubleshooting
Best Practices
| Topic | URL |
|---|---|
| Apply responsible AI practices in Microsoft Discovery | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-responsible-ai |
| Apply naming rules for Microsoft Discovery resources | https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-resource-naming |
Decision Making
| Topic | URL |
|---|---|
| Choose Microsoft Discovery architecture and fixed settings | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-deployment-decisions |
| Plan Microsoft Discovery deployment paths and prerequisites | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-deployment-planning |
| Choose the right Microsoft Discovery agent type | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-agent-types |
| Plan Microsoft Discovery onboarding network mode and routing | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-plan-deployment-network |
| Select appropriate models for Discovery agents | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-select-models-for-agents |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Use advanced shared session patterns with Discovery Engine | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-advanced-investigation-patterns |
| Apply trust and basic shared session patterns in Discovery | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-trust-basic-investigation-patterns |
Limits & Quotas
| Topic | URL |
|---|---|
| Quota and capacity reservations for Discovery deployments | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-quota-reservation |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Understand AKS upgrade behavior for Discovery Supercomputer | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-supercomputer-aks-upgrades |
| Deploy Microsoft Discovery across multiple Azure regions | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-across-regions |
| Deploy a fully network-hardened Microsoft Discovery stack | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-network-hardened-stack |
| Deploy core Microsoft Discovery platform with onboarding tool | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-platform |
| Prepare Azure landing zone for Microsoft Discovery | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-prepare-landing-zone |
| Publish Discovery tool images to Azure Container Registry | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-publish-tool-to-acr |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/microsoftdocs/agent-skills/azure-microsoft-discovery">View azure-microsoft-discovery on skillZs</a>