azure-copilot — Claude Code skill: what it does, how to install
Skill for Azure Copilot work: VM sizing, Bicep and Terraform generation, Cosmos DB setup for chat storage, Azure network design.
CC-BY-4.0 180 installs ★ 818 updated 2026-11-09
npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -a claude-codeWhat azure-copilot does
The skill provides a reference guide for Azure Copilot and fetches live documentation from learn.microsoft.com via the mcp_microsoftdocs MCP server or fetch_webpage. Covers Azure App Service and Functions diagnostics, VM disk performance analysis, Load Balancer SKU selection, storage account migration, Entra role-based access control, Defender EASM attack surface queries.
Inside is a category index with line ranges and links to skill sections: Troubleshooting, Decision Making, Architecture & Design Patterns, Security, Configuration, Integrations & Coding Patterns. Each category lists topics and documentation URLs. The agent reads the relevant skill section and fetches the current page from the link.
The skill needs network access. If mcp_microsoftdocs is unavailable, the agent falls back to fetch_webpage with from=learn-agent-skill&accept=text/markdown. The skill generator stamps a build date in metadata; if more than three months old, the agent will offer to update the skill from the repository.
What it helps with
- size Azure VMs to fit budget and load
- generate Bicep or Terraform templates for infrastructure
- set up Cosmos DB as storage for Copilot conversation history
- diagnose slow I/O on Azure VM disks
- design and validate Azure network architecture with routing and security
Example prompts for the agent
- Pick a cost-efficient VM for a web app handling 1000 users per day
- Generate a Terraform config for a VNet with three subnets
- Show how to configure Cosmos DB for Azure Copilot chat storage
How to install azure-copilot
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -a claude-code2Manually: put the files in place
~/.claude/skills/azure-copilot/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-copilot/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -a codex2Manually: put the files in place
.agents/skills/azure-copilot/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -a cursor2Manually: put the files in place
.cursor/skills/azure-copilot/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-copilot2Manually: put the files in place
.github/skills/azure-copilot/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-copilotManually: put the files in place
.devin/skills/azure-copilot/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -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-copilot
How to install azure-copilot in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-copilot -a claude-code. The skill will appear in ~/.claude/skills/azure-copilot/SKILL.md.
What does the azure-copilot skill do?
Gives the agent a reference guide for Azure Copilot and the ability to fetch current Microsoft Learn documentation. Assists with VM sizing, Bicep and Terraform generation, Cosmos DB setup for chats, network design, App Service and disk diagnostics.
What does azure-copilot require?
Network access and the mcp_microsoftdocs MCP server (can fall back to fetch_webpage). If the skill build date is older than three months, the agent will suggest updating it from the repository.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-copilot description: Expert knowledge for Azure Copilot development including troubleshooting, decision making, architecture & design patterns, security, configuration, and integrations & coding patterns. Use when sizing VMs, generating Bicep/Terraform, configuring Cosmos DB chat storage, or designing Azure networks, and other Azure Copilot related development tasks. Not for Azure Portal (use azure-portal), Azure Machine Learning (use azure-machine-learning), Azure DevOps (use azure-devops), Microsoft Foundry (use microsoft-foundry). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-11-08" generator: "docs2skills/1.0.0" --- # Azure Copilot Skill This skill provides expert guidance for Azure Copilot. Covers troubleshooting, decision making, architecture & design patterns, security, configuration, and integrations & coding patterns. 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 | Using Copilot to diagnose and resolve Azure App Service/Functions issues and analyze Azure VM disk performance problems, including slow I/O and bottlenecks. | | Decision Making | L40-L48 | Using Copilot to compare options and make cost‑efficient Azure decisions: VM sizing, workload templates, Marketplace offers, storage estate insights, and Load Balancer SKU selection. | | Architecture & Design Patterns | L49-L53 | Using Copilot to design, validate, and troubleshoot Azure network architectures, including connectivity, routing, security, and performance issues across VNets and hybrid setups. | | Security | L54-L61 | Using Copilot for secure storage modernization, managing access via Entra roles, querying Defender EASM attack surface data, and understanding responsible AI and data handling in Azure Copilot | | Configuration | L62-L66 | Setting up Cosmos DB as storage for Azure Copilot conversations, including configuration steps, required settings, and best practices for data persistence. | | Integrations & Coding Patterns | L67-L72 | Using Azure Copilot to generate and refine infra-as-code and automation: APIM policies, Azure CLI/PowerShell scripts, Kubernetes YAML for AKS, and Terraform/Bicep templates. | ### Troubleshooting | Topic | URL | |-------|-----| | Troubleshoot Azure App Service and Functions with Copilot | https://learn.microsoft.com/en-us/azure/copilot/troubleshoot-app-service | | Troubleshoot Azure VM disk performance using Copilot | https://learn.microsoft.com/en-us/azure/copilot/troubleshoot-disk-performance | ### Decision Making | Topic | URL | |-------|-----| | Use Azure Copilot to analyze and optimize cloud costs | https://learn.microsoft.com/en-us/azure/copilot/analyze-cost-management | | Choose and deploy cost-efficient Azure VMs with Copilot | https://learn.microsoft.com/en-us/azure/copilot/deploy-vms-effectively | | Find and deploy workload templates using Azure Copilot | https://learn.microsoft.com/en-us/azure/copilot/deploy-workload-templates | | Find suitable Azure Marketplace solutions with Copilot | https://learn.microsoft.com/en-us/azure/copilot/discover-marketplace | | Select and manage Azure Load Balancer SKUs with Copilot | https://learn.microsoft.com/en-us/azure/copilot/work-load-balancer | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Design and troubleshoot Azure networks with Copilot | https://learn.microsoft.com/en-us/azure/copilot/copilot-networking | ### Security | Topic | URL | |-------|-----| | Improve and migrate Azure storage accounts with Copilot | https://learn.microsoft.com/en-us/azure/copilot/improve-storage-accounts | | Manage Azure Copilot access with Entra roles | https://learn.microsoft.com/en-us/azure/copilot/manage-access | | Query Defender EASM attack surface insights with Azure Copilot | https://learn.microsoft.com/en-us/azure/copilot/query-attack-surface | | Understand responsible AI and data use in Azure Copilot | https://learn.microsoft.com/en-us/azure/copilot/responsible-ai-faq | ### Configuration | Topic | URL | |-------|-----| | Configure Cosmos DB storage for Copilot conversations | https://learn.microsoft.com/en-us/azure/copilot/bring-your-own-storage | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Author Azure API Management policies using Copilot | https://learn.microsoft.com/en-us/azure/copilot/author-api-management-policies | | Generate Kubernetes YAML for AKS with Azure Copilot | https://learn.microsoft.com/en-us/azure/copilot/generate-kubernetes-yaml | | Create Terraform and Bicep configurations with Azure Copilot | https://learn.microsoft.com/en-us/azure/copilot/generate-terraform-bicep |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills