Skip to main content
skill CX Codex

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

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

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

2Manually: put the files in place

~/.claude/skills/azure-copilot/SKILL.md

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

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-managed-redis A skill for Claude Code and Codex designed to guide Azure Managed Redis development. It supplies architecture patterns, Entra ID setup steps, and diagnostics for connection drops. CX Codex +1 182installs azure-api-center Skill with Azure API Center documentation for development, security configuration, and API registration automation. Connects to local reference and Microsoft Learn docs. CX Codex +1 181installs azure-queue-storage Guides coding agents through Azure Queue Storage tasks, including Entra ID security, service limits, monitoring setup, and SDK usage across multiple languages. CX Codex +1 181installs azure-portal This skill gives your agent knowledge about Azure Portal: access control, security policies, dashboard configuration, and troubleshooting. Install it if you manage portal settings, handle access issues, or work with Azure mobile apps. CX Codex +1 181installs azure-bot-service azure-bot-service — a skill for Azure AI Bot Service development. Provides expert guidance on channel setup, Direct Line 3.0, security, deployment, and debugging issues in the Bot Framework. CX Codex +1 180installs azure-content-safety azure-content-safety — a skill for Azure AI Content Safety development: text and image moderation, blocklist setup, groundedness checks, and prompt injection defense. CX Codex +1 180installs azure-firewall-manager Guides Azure Firewall Manager configuration, security policies, and architectural choices. Useful when setting up secured virtual hubs, DDoS plans, or WAF. CX Codex +1 180installs azure-traffic-manager Expert skill for Azure Traffic Manager: traffic routing, profile architecture, IaC with ARM/Bicep/Terraform. Covers endpoint configuration, routing methods, and troubleshooting degraded profiles. CX Codex +1 178installs

Project sponsors

Companies that keep this analytics open