1---
2name: azure-cost
3description: "Unified Azure cost management: query historical costs, forecast future spending, and optimize to reduce waste. WHEN: \"Azure costs\", \"Azure spending\", \"Azure bill\", \"cost breakdown\", \"cost by service\", \"cost by resource\", \"how much am I spending\", \"show my bill\", \"monthly cost summary\", \"cost trends\", \"top cost drivers\", \"actual cost\", \"amortized cost\", \"forecast spending\", \"projected costs\", \"estimate bill\", \"future costs\", \"budget forecast\", \"end of month costs\", \"how much will I spend\", \"optimize costs\", \"reduce spending\", \"find cost savings\", \"orphaned resources\", \"rightsize VMs\", \"cost analysis\", \"reduce waste\", \"unused resources\", \"optimize Redis costs\", \"cost by tag\", \"cost by resource group\", \"AKS cost analysis add-on\", \"namespace cost\", \"cost spike\", \"anomaly\", \"budget alert\", \"AKS cost visibility\". DO NOT USE FOR: deploying resources, provisioning infrastructure, diagnostics, security audits, or estimating costs for new resources not yet deployed."
4license: MIT
5metadata:
6  author: Microsoft
7  version: "1.2.1"
8---
9 
10# Azure Cost Management Skill
11 
12Unified skill for all Azure cost management tasks: querying historical costs, forecasting future spending, and optimizing to reduce waste.
13 
14## When to Use This Skill
15 
16Activate this skill when user wants to:
17- Query or analyze Azure costs (how much am I spending, show my bill, cost breakdown)
18- Break down costs by service, resource, location, or tag
19- Analyze cost trends over time
20- Forecast future Azure spending or project end-of-month costs
21- Optimize Azure costs, reduce spending, or find savings
22- Find orphaned or unused resources
23- Rightsize Azure VMs, containers, or services
24- Generate cost optimization reports
25 
26## Quick Reference
27 
28| Property | Value |
29|----------|-------|
30| **Query API Endpoint** | `POST {scope}/providers/Microsoft.CostManagement/query?api-version=2023-11-01` |
31| **Forecast API Endpoint** | `POST {scope}/providers/Microsoft.CostManagement/forecast?api-version=2023-11-01` |
32| **MCP Tools** | `azure__documentation`, `azure__extension_cli_generate`, `azure__get_azure_bestpractices` |
33| **CLI** | `az rest`, `az monitor metrics list`, `az resource list` |
34| **Required Role** | Cost Management Reader + Monitoring Reader + Reader on scope |
35 
36## MCP Tools
37 
38| Tool | Description | Parameters | When to Use |
39|------|-------------|------------|-------------|
40| `azure__documentation` | Search Azure documentation | `query` (Required): search terms | Research Cost Management API parameters and options |
41| `azure__extension_cli_generate` | Generate Azure CLI commands | `intent` (Required): task description, `cli-type` (Required): `"az"` | Construct `az rest` commands for cost queries |
42| `azure__get_azure_bestpractices` | Get Azure best practices | `intent` (Required): optimization context | Inform query design with cost management best practices |
43| `azure__extension_azqr` | Run Azure Quick Review compliance scan | `subscription` (Required): subscription ID, `resource-group` (Optional): resource group name | Find orphaned resources and cost optimization opportunities |
44| `azure__aks` | Azure Kubernetes Service operations | varies by sub-command | AKS cost analysis: list clusters, get node pools, inspect configuration |
45 
46> 💡 **Tip:** Prefer MCP tools over direct CLI commands. Use `az rest` only when MCP tools don't cover the specific operation.
47 
48---
49 
50## Routing
51 
52Read the user's request and follow the appropriate workflow below.
53 
54| User Intent | Workflow | Example Prompts |
55|-------------|----------|-----------------|
56| Understand current costs | [Cost Query Workflow](cost-query/workflow.md) | "how much am I spending", "cost by service", "show my bill" |
57| Reduce costs / find waste | [Cost Optimization Workflow](cost-optimization/workflow.md) | "optimize costs", "find orphaned resources", "reduce spending" |
58| Project future costs | [Cost Forecast Workflow](cost-forecast/workflow.md) | "forecast costs", "end of month estimate", "how much will I spend" |
59| Full cost picture | All three workflows combined | "give me the full picture of my Azure costs" |
60 
61> **Important:** When optimizing costs, always present the total bill and cost breakdown alongside optimization recommendations.
62 
63---
64 
65## Scope Reference (Shared Across All Workflows)
66 
67| Scope | URL Pattern |
68|-------|-------------|
69| Subscription | `/subscriptions/<subscription-id>` |
70| Resource Group | `/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>` |
71| Management Group | `/providers/Microsoft.Management/managementGroups/<management-group-id>` |
72| Billing Account | `/providers/Microsoft.Billing/billingAccounts/<billing-account-id>` |
73| Billing Profile | `/providers/Microsoft.Billing/billingAccounts/<billing-account-id>/billingProfiles/<billing-profile-id>` |
74 
75> 💡 **Tip:** These are scope paths only — not complete URLs. Combine with the API endpoint and version.
76 
77---
78 
79## Part 1: Cost Query Workflow
80 
81For the full cost query workflow (scope selection, report types, timeframes, dataset configuration, API calls, pagination, guardrails, examples, and error handling), see:
82 
83📄 **[Cost Query Workflow](cost-query/workflow.md)**
84 
85---
86 
87## Part 2: Cost Optimization Workflow
88 
89For the full cost optimization workflow (prerequisites, best practices, Redis/AKS-specific analysis, Azure Quick Review, resource discovery, cost queries, pricing validation, utilization metrics, and report generation), see:
90 
91📄 **[Cost Optimization Workflow](cost-optimization/workflow.md)**
92 
93---
94 
95## Part 3: Cost Forecast Workflow
96 
97For the full cost forecast workflow (scope selection, time period rules, dataset configuration, forecast-specific options, API calls, response interpretation, guardrails, and error handling), see:
98 
99📄 **[Cost Forecast Workflow](cost-forecast/workflow.md)**
100 
101---
102 
103## Data Classification
104 
105- **ACTUAL DATA** = Retrieved from Azure Cost Management API
106- **ACTUAL METRICS** = Retrieved from Azure Monitor
107- **VALIDATED PRICING** = Retrieved from official Azure pricing pages
108- **ESTIMATED SAVINGS** = Calculated based on actual data and validated pricing
109 
110## Best Practices
111 
112- Always query actual costs first — never estimate or assume
113- Always present the total bill alongside optimization recommendations
114- Validate pricing from official sources — account for free tiers
115- Use REST API for cost queries (more reliable than `az costmanagement query`)
116- Always include the `ClientType: GitHubCopilotForAzure` header on all Cost Management API requests (`--headers "ClientType=GitHubCopilotForAzure"` in `az rest`)
117- Save audit trail — include all queries and responses
118- Include Azure Portal links for all resources
119- For costs < $10/month, emphasize operational improvements over financial savings
120- Never execute destructive operations without explicit approval
121- On 429 responses, check all `x-ms-ratelimit-microsoft.costmanagement-*-retry-after` headers (`qpu-retry-after`, `entity-retry-after`, `tenant-retry-after`), wait for the longest value, and do not retry until that duration has elapsed. The per-scope limit (4 requests/minute) is the most restrictive.
122 
123## Common Pitfalls
124 
125- **Assuming costs**: Always query actual data from Cost Management API
126- **Ignoring free tiers**: Many services have generous allowances
127- **Using wrong date ranges**: 30 days for costs, 14 days for utilization
128- **Not showing the bill**: Always present cost breakdown alongside optimization recommendations
129- **Cost query failures**: Use `az rest` with JSON body, not `az costmanagement query`
130 
131## Safety Requirements
132 
133- Get approval before deleting resources
134- Test changes in non-production first
135- Provide dry-run commands for validation
136- Include rollback procedures
137 
138## SDK Quick References
139 
140- **Redis Management**: [.NET](cost-optimization/sdk/azure-resource-manager-redis-dotnet.md)
141