About azure-local
A skill with guidance for planning, deploying, operating, and troubleshooting standard Azure Local environments, including Azure Stack HCI. Multi-rack deployments are handled by a separate skill.
Key features
- 01Planning and deployment guidance
- 02Operations and lifecycle updates
- 03Manage VM, AKS, and other workloads
- 04Networking and security guidance
- 05Troubleshooting workflows
Use cases
- 01Plan a standard Azure Local deployment
- 02Update clusters and manage workloads
- 03Investigate network or cluster issues
MCP support
There is no dedicated Azure Local MCP namespace; the skill uses generic Azure MCP tools for resource queries, monitoring, health checks, and documentation.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-localAfter installing, type/azure-localin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/docs-map.mdmcp-and-cli-tools.mdresource-types.mdsafety-rules.mdworkflows/networking-and-security/networking-and-security.mdworkflows/operate-and-update/operate-and-update.mdworkflows/plan-and-deploy/plan-and-deploy.mdworkflows/troubleshooting/troubleshooting.mdworkflows/workload-management/workload-management.mdDetails
From the project READMEAzure Local
Quick Reference
| Property | Value |
|---|---|
| Best for | Azure Local planning, deployment, operations, workloads |
| MCP Tools | Generic Azure MCP tools only; no Azure Local namespace |
| CLI | az graph query, az resource show, Azure Local PowerShell |
| Related skills | azure-compute (public VMs), azure-kubernetes (public AKS) |
When to Use This Skill
Use for Azure Local, Azure Stack HCI, Azure Local VMs, AKS on Azure Local, AKS hybrid, SDN, lifecycle updates, disconnected sites, or troubleshooting. Covers standard deployments (1-16 node hyperconverged, up to 64 disaggregated) and rack-aware clusters.
Do not use for cloud VM or public AKS guidance, or for multi-rack (rack scale) deployments — those use a separate control plane and procedure set. Hand off to the azure-local-multi-rack skill.
MCP Tools
Azure Local has no dedicated MCP namespace. Use generic Azure MCP tools: mcp_azure_mcp_extension_cli_generate (ARG/CLI inventory), mcp_azure_mcp_monitor (needs Log Analytics), mcp_azure_mcp_resourcehealth (partial; not local cluster health), mcp_azure_mcp_documentation (pass the user's version when known).
Scope and limitations: mcp-and-cli-tools.
Workflow
- Confirm deployment scale. If the user mentions multi-rack, aggregation racks, Network Fabric Controller, Cluster Manager, or
Microsoft.NetworkCloudresources, stop and use theazure-local-multi-rackskill instead. - Deploy -> plan-and-deploy
- Operate/update -> operate-and-update
- VMs, AKS, images, disks, networks -> workload-management
- SDN, NSG, load balancer, gateway -> networking-and-security
- Failures -> troubleshooting
Read the matched workflow first and use docs-map. Start read-only. Ask before updates, deletes, reimages, network changes, VM power/delete operations, or Arc bridge/custom location changes.
Error Handling
| Scenario | Remediation |
|---|---|
| Scale unknown | Ask whether the deployment is standard or multi-rack before giving procedures. |
| Multi-rack detected | Hand off to the azure-local-multi-rack skill; these procedures do not apply. |
| Version unknown | Ask for the Azure Local version, or use latest docs. |
| Risky change detected | Stop and follow safety-rules. |
| No local access | Stay with Azure control-plane checks only. |
| Doc URL 404/redirect | Search Learn for the article title with the user's version. |