About azure-stack-edge
A guidance skill for agents working with Azure Stack Edge, covering device configuration, deployment, security, and troubleshooting. It combines a local topic index with network-based access to Microsoft documentation.
Key features
- 01Device issue and alert troubleshooting
- 02Configuration, deployment, and operations guidance
- 03Security and quota references
- 04Integration and workload patterns
- 05Local index and remote documentation retrieval
Use cases
- 01Diagnose activation, certificate, or storage issues
- 02Plan disconnected deployments and region choices
- 03Configure Kubernetes, VM, or GPU workloads
MCP support
The skill can fetch Microsoft documentation through mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-stack-edgeAfter installing, type/azure-stack-edgein Claude Code to confirm it loaded.
Details
From the project READMEAzure Stack Edge Skill
This skill provides expert guidance for Azure Stack Edge. Covers troubleshooting, best practices, decision making, 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 | L36-L87 | Release-specific known issues, alerts, and fixes for Azure Stack Edge/Data Box Gateway, plus troubleshooting for ordering, activation, certificates, ARM, storage, IoT Edge, VMs, GPU, diagnostics, and logs. |
| Best Practices | L88-L93 | Best practices for Azure Stack Edge Pro: device failure recovery, GPU sharing/partitioning guidance, and operational guidelines for deployment, monitoring, and maintenance. |
| Decision Making | L94-L102 | Guidance on region and data-location choices, resiliency behavior, disconnected deployment planning, and processes for replacing Azure Stack Edge devices. |
| Limits & Quotas | L103-L115 | Limits, capacities, performance, and system requirements for Azure Stack Edge and Data Box Gateway devices, including supported VM sizes, GPU limits, and cross-subscription resource moves. |
| Security | L116-L142 | Securing Azure Stack Edge: user access, certificates/TLS, Key Vault secrets, VPN/BCDR, encryption, secure wipe, Kubernetes RBAC, and built-in security features/policies. |
| Configuration | L143-L195 | Configuring and managing Azure Stack Edge/Data Box Gateway devices: networking, power, storage, Kubernetes/VMs, GPUs, monitoring, automation, and hardware/system requirements. |
| Integrations & Coding Patterns | L196-L207 | How to deploy and integrate workloads on Azure Stack Edge: IoT Edge modules, GPU-sharing/Kubernetes apps, DeepStream, Arc/Kubernetes GitOps, and connecting to local ARM. |
| Deployment | L208-L211 | Predeployment requirements and planning for Azure Stack Edge Pro GPU, including hardware, networking, certificates, capacity, and environment checks before deployment. |
Troubleshooting
Best Practices
| Topic | URL |
|---|---|
| Recover from Azure Stack Edge Pro device failure | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-recover-device-failure |
| Use GPU sharing options on Azure Stack Edge Pro GPU | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-sharing |
Decision Making
| Topic | URL |
|---|---|
| Understand data residency options for Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-data-residency |
| Understand data resiliency behavior for Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-data-resiliency |
| Plan disconnected Azure Stack Edge deployments | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-disconnected-scenario |
| Choose Azure regions for Azure Stack Edge service and data | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-regions |
| Request and provision a replacement Azure Stack Edge device | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-replace-device |
Limits & Quotas
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Predeployment checklist for Azure Stack Edge Pro GPU | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-checklist |