azure-dedicated-hsm — Claude Code skill: Azure Dedicated HSM guide
Hands the agent a working map of Azure Dedicated HSM: cluster sizing, networking, secure configuration and migration, with links into Microsoft Learn.
CC-BY-4.0 162 installs ★ 818 updated 2026-10-25
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a claude-codeWhat azure-dedicated-hsm does
The skill sorts Azure Dedicated HSM know-how into categories: troubleshooting, retirement planning, architecture and failover, physical security, CLI and PowerShell provisioning, ExpressRoute gateway IP SKU migration. Each category points at a line range inside SKILL.md or at a reference file the agent opens when needed.
The agent walks the index, then pulls the real pages from Microsoft Learn. Network access is required: mcp_microsoftdocs:microsoft_docs_fetch is the preferred route, fetch_webpage the fallback. Cut the network and there is nothing to read.
Scope stays narrow. Cloud HSM, Key Vault and Payment HSM have their own skills, so this one should not be pointed at them. Moving workloads to Managed or Cloud HSM, and swapping the ExpressRoute gateway IP SKU, sit inside the same index.
What it helps with
- size an HSM cluster for a workload
- plan failover and VNet topology
- move an ExpressRoute gateway to another IP SKU
- trace why an HSM deployment failed
- draft a retirement plan for the service
Example prompts for the agent
- Plan the move from Azure Dedicated HSM to Cloud HSM
- Show how to lock down the VNet for an HSM: subnets and routing
- Write an Azure CLI script that provisions a Dedicated HSM
How to install azure-dedicated-hsm
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a claude-code2Manually: put the files in place
~/.claude/skills/azure-dedicated-hsm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-dedicated-hsm/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a codex2Manually: put the files in place
.agents/skills/azure-dedicated-hsm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a cursor2Manually: put the files in place
.cursor/skills/azure-dedicated-hsm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-dedicated-hsm2Manually: put the files in place
.github/skills/azure-dedicated-hsm/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-dedicated-hsmManually: put the files in place
.devin/skills/azure-dedicated-hsm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-dedicated-hsm
How do I install azure-dedicated-hsm in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a claude-code. The skill lands at ~/.claude/skills/azure-dedicated-hsm/SKILL.md.
What does azure-dedicated-hsm do?
It gives the agent a reference on Azure Dedicated HSM covering diagnosis, design, security and provisioning with CLI or PowerShell. Docs are fetched from Microsoft Learn through the links in its index.
Does it cover Cloud HSM or Key Vault?
No. Those have their own skills (azure-cloud-hsm, azure-key-vault, azure-payment-hsm); this one stays on Dedicated HSM.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-dedicated-hsm description: Expert knowledge for Azure Dedicated HSM development including troubleshooting, decision making, architecture & design patterns, security, integrations & coding patterns, and deployment. Use when sizing HSM clusters, configuring ExpressRoute IP SKUs, securing VNets, planning HSM retirement, or scripting CLI/PowerShell provisioning, and other Azure Dedicated HSM related development tasks. Not for Azure Cloud Hsm (use azure-cloud-hsm), Azure Key Vault (use azure-key-vault), Azure Payment Hsm (use azure-payment-hsm). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-10-18" generator: "docs2skills/1.0.0" --- # Azure Dedicated HSM Skill This skill provides expert guidance for Azure Dedicated HSM. Covers troubleshooting, decision making, architecture & design patterns, security, 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) 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 | L34-L39 | Diagnosing and fixing common Azure Dedicated HSM issues, including deployment failures, connectivity, configuration, and operational problems during setup and usage. | | Decision Making | L40-L44 | Guidance on Dedicated HSM retirement, choosing successors (Managed/Cloud HSM), and planning/migrating ExpressRoute IPs and HSM workloads to new SKUs or services. | | Architecture & Design Patterns | L45-L51 | Guidance on designing Dedicated HSM deployments: sizing and topology, high availability and failover patterns, and secure networking (VNet, subnets, routing, and connectivity). | | Security | L52-L57 | Physical security controls for Dedicated HSM hardware and best‑practice configuration guidance (networking, access, policies) to securely deploy and operate HSMs. | | Integrations & Coding Patterns | L58-L65 | Scripts and step-by-step guidance for provisioning and deploying Azure Dedicated HSM instances using PowerShell and Azure CLI. | | Deployment | L66-L69 | Guidance for migrating the ExpressRoute gateway IP SKU used with Azure Dedicated HSM, including steps, prerequisites, and configuration considerations. | ### Troubleshooting | Topic | URL | |-------|-----| | Resolve common issues with Azure Dedicated HSM | https://learn.microsoft.com/en-us/azure/dedicated-hsm/faq | | Troubleshoot Azure Dedicated HSM deployments and usage | https://learn.microsoft.com/en-us/azure/dedicated-hsm/troubleshoot | ### Decision Making | Topic | URL | |-------|-----| | Plan migration from Azure Dedicated HSM to Managed or Cloud HSM | https://learn.microsoft.com/en-us/azure/dedicated-hsm/migration-guide | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Design deployment architecture for Azure Dedicated HSM | https://learn.microsoft.com/en-us/azure/dedicated-hsm/deployment-architecture | | Design high availability for Azure Dedicated HSM | https://learn.microsoft.com/en-us/azure/dedicated-hsm/high-availability | | Plan networking architecture for Azure Dedicated HSM | https://learn.microsoft.com/en-us/azure/dedicated-hsm/networking | ### Security | Topic | URL | |-------|-----| | Understand physical security of Azure Dedicated HSM devices | https://learn.microsoft.com/en-us/azure/dedicated-hsm/physical-security | | Secure configuration for Azure Dedicated HSM | https://learn.microsoft.com/en-us/azure/dedicated-hsm/secure-dedicated-hsm | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Create Azure Dedicated HSM using PowerShell | https://learn.microsoft.com/en-us/azure/dedicated-hsm/quickstart-create-hsm-powershell | | Create Azure Dedicated HSM using Azure CLI | https://learn.microsoft.com/en-us/azure/dedicated-hsm/quickstart-hsm-azure-cli | | Deploy Azure Dedicated HSM with Azure CLI | https://learn.microsoft.com/en-us/azure/dedicated-hsm/tutorial-deploy-hsm-cli | | Deploy Azure Dedicated HSM with PowerShell | https://learn.microsoft.com/en-us/azure/dedicated-hsm/tutorial-deploy-hsm-powershell | ### Deployment | Topic | URL | |-------|-----| | Migrate Dedicated HSM ExpressRoute gateway IP SKU | https://learn.microsoft.com/en-us/azure/dedicated-hsm/migration-basic-standard |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills