Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-dedicated-hsm -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/azure-dedicated-hsm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-dedicated-hsm/

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-planetary-computer-pro The azure-planetary-computer-pro skill guides agents through Microsoft Planetary Computer Pro work, from GeoCatalog and STAC APIs to security, configuration, and integrations. CX Codex +1 162installs azure-large-instances Hands the agent a working reference for Azure Large Instances: Epic SKU caps, volume group sizing, EHR storage, connection faults. CX Codex +1 162installs azure-data-share Guides agents through Azure Data Share architecture, troubleshooting, and deployments using official Microsoft Learn docs. CX Codex +1 162installs azure-relay This skill guides Azure Relay setup, error diagnosis, and Hybrid Connections work. It fits projects using .NET or Node.js relay clients. CX Codex +1 162installs azure-osconfig This skill guides Azure OSConfig development, from diagnosing agent and Azure IoT Hub issues to configuring Windows security and Linux devices. CX Codex +1 161installs azure-open-datasets A reference skill for Azure Open Datasets limits: throttling on non-Spark downloads, quota ceilings and retry handling, pulled from Microsoft Learn docs. CX Codex +1 161installs azure-immersive-reader A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure AI Immersive Reader expertise to the agent. Covers JS SDK integration, Entra auth setup, read-aloud configuration, and language support. CX Codex +1 161installs azure-import-export This skill guides work on Azure Import/Export jobs, from diagnosing failures to checking service limits and configuring encryption keys. Use it while building or troubleshooting these jobs. CX Codex +1 161installs

Project sponsors

Companies that keep this analytics open