Cloudofficial

azure-costโ–Œ

microsoft/GitHub-Copilot-for-Azure ยท updated Apr 8, 2026

$npx skills add https://github.com/microsoft/GitHub-Copilot-for-Azure --skill azure-cost
summary

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 co

skill.md

Azure Cost Management Skill

Unified skill for all Azure cost management tasks: querying historical costs, forecasting future spending, and optimizing to reduce waste.

When to Use This Skill

Activate this skill when user wants to:

  • Query or analyze Azure costs (how much am I spending, show my bill, cost breakdown)
  • Break down costs by service, resource, location, or tag
  • Analyze cost trends over time
  • Forecast future Azure spending or project end-of-month costs
  • Optimize Azure costs, reduce spending, or find savings
  • Find orphaned or unused resources
  • Rightsize Azure VMs, containers, or services
  • Generate cost optimization reports

Quick Reference

PropertyValue
Query API EndpointPOST {scope}/providers/Microsoft.CostManagement/query?api-version=2023-11-01
Forecast API EndpointPOST {scope}/providers/Microsoft.CostManagement/forecast?api-version=2023-11-01
MCP Toolsazure__documentation, azure__extension_cli_generate, azure__get_azure_bestpractices
CLIaz rest, az monitor metrics list, az resource list
Required RoleCost Management Reader + Monitoring Reader + Reader on scope

MCP Tools

ToolDescriptionParametersWhen to Use
azure__documentationSearch Azure documentationquery (Required): search termsResearch Cost Management API parameters and options
azure__extension_cli_generateGenerate Azure CLI commandsintent (Required): task description, cli-type (Required): "az"Construct az rest commands for cost queries
azure__get_azure_bestpracticesGet Azure best practicesintent (Required): optimization contextInform query design with cost management best practices
azure__extension_azqrRun Azure Quick Review compliance scansubscription (Required): subscription ID, resource-group (Optional): resource group nameFind orphaned resources and cost optimization opportunities
azure__aksAzure Kubernetes Service operationsvaries by sub-commandAKS cost analysis: list clusters, get node pools, inspect configuration

๐Ÿ’ก Tip: Prefer MCP tools over direct CLI commands. Use az rest only when MCP tools don't cover the specific operation.


Routing

Read the user's request and follow the appropriate workflow below.

User IntentWorkflowExample Prompts
Understand current costsCost Query Workflow"how much am I spending", "cost by service", "show my bill"
Reduce costs / find wasteCost Optimization Workflow"optimize costs", "find orphaned resources", "reduce spending"
Project future costsCost Forecast Workflow"forecast costs", "end of month estimate", "how much will I spend"
Full cost pictureAll three workflows combined"give me the full picture of my Azure costs"

Important: When optimizing costs, always present the total bill and cost breakdown alongside optimization recommendations.


Scope Reference (Shared Across All Workflows)

ScopeURL Pattern
Subscription/subscriptions/<subscription-id>
Resource Group/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>
Management Group/providers/Microsoft.Management/managementGroups/<management-group-id>
Billing Account/providers/Microsoft.Billing/billingAccounts/<billing-account-id>
Billing Profile/providers/Microsoft.Billing/billingAccounts/<billing-account-id>/billingProfiles/<billing-profile-id>

๐Ÿ’ก Tip: These are scope paths only โ€” not complete URLs. Combine with the API endpoint and version.


Part 1: Cost Query Workflow

For the full cost query workflow (scope selection, report types, timeframes, dataset configuration, API calls, pagination, guardrails, examples, and error handling), see:

๐Ÿ“„ Cost Query Workflow


Part 2: Cost Optimization Workflow

For 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:

๐Ÿ“„ Cost Optimization Workflow


Part 3: Cost Forecast Workflow

For the full cost forecast workflow (scope selection, time period rules, dataset configuration, forecast-specific options, API calls, response interpretation, guardrails, and error handling), see:

๐Ÿ“„ Cost Forecast Workflow


Data Classification

  • ACTUAL DATA = Retrieved from Azure Cost Management API
  • ACTUAL METRICS = Retrieved from Azure Monitor
  • VALIDATED PRICING = Retrieved from official Azure pricing pages
  • ESTIMATED SAVINGS = Calculated based on actual data and validated pricing

Best Practices

  • Always query actual costs first โ€” never estimate or assume
  • Always present the total bill alongside optimization recommendations
  • Validate pricing from official sources โ€” account for free tiers
  • Use REST API for cost queries (more reliable than az costmanagement query)
  • Save audit trail โ€” include all queries and responses
  • Include Azure Portal links for all resources
  • For costs < $10/month, emphasize operational improvements over financial savings
  • Never execute destructive operations without explicit approval

Common Pitfalls

  • Assuming costs: Always query actual data from Cost Management API
  • Ignoring free tiers: Many services have generous allowances
  • Using wrong date ranges: 30 days for costs, 14 days for utilization
  • Not showing the bill: Always present cost breakdown alongside optimization recommendations
  • Cost query failures: Use az rest with JSON body, not az costmanagement query

Safety Requirements

  • Get approval before deleting resources
  • Test changes in non-production first
  • Provide dry-run commands for validation
  • Include rollback procedures

SDK Quick References

  • Redis Management: .NET