🇺🇸English

Azure Cost Calculator

Deterministic Azure cost estimation using the public Retail Prices API. Never guess prices — always query the live API via the scripts.

Runtime Detection

Choose the script runtime based on what is available:

Both produce identical JSON output. Bash flags use --kebab-case equivalents of PowerShell -PascalCase parameters (e.g., -ServiceName → --service-name).

Declarative Parameters

Service reference files specify query parameters as Key: Value pairs. To execute a query, translate each parameter to the detected runtime's syntax:

• Bash : --kebab-case flags (e.g., ServiceName: Virtual Machines → --service-name 'Virtual Machines')
• PowerShell : -PascalCase flags (e.g., ServiceName: Virtual Machines → -ServiceName 'Virtual Machines')

String values with spaces require quoting when passed to scripts. Numeric values (Quantity, InstanceCount) do not.

Workflow

Phase 1 — Analysis (no API queries)

1. Parse — extract resource types, quantities, and sizing from user's architecture

2. Clarify — if any of these are true, stop and ask before continuing:

   • A resource maps to a category but not a specific service (e.g., "a database") → list 2–4 options
   • A resource has no count, no sizing/tier, or no workload scale (RU/s, executions, DTUs) → ask for specifics
   • User describes a goal without a hosting model (e.g., "a web app") → present 2–3 options with trade-offs
   • Batch all gaps into one prompt. Offer concrete choices. One round max — if user declines, carry gaps forward as never-assume items in Step 6.

3. Locate each service reference: a. File search — search for files matching references/services/**/*<keyword>*.md b. Routing map — if search returns 0 or ambiguous results, check references/service-routing.md for the authoritative category and filename c. Category browse — if not found in routing map, read the category index in references/shared.md d. Broad search — list or search references/services/**/*.md to see all available files e. Discovery — if no file exists, use the explore script to find the service in the API

 * If **any never-assume parameter** is missing → ask user before proceeding
 * If only safe-default gaps remain → disclose defaults and proceed to Phase 2
 * **Single-service shortcut** : skip this table for single-service estimates where all parameters are specified

Phase 2 — Estimation

1. Query — run the pricing script for each service using parameters from service files + user input + resolved defaults
2. Calculate — apply cost formulas from service files; multiply by quantities
3. Verify arithmetic — for each line item, restate the formula with actual numbers, compute, and confirm the result. If any intermediate calculation involves multiplication of two numbers > 10, compute it step-by-step (e.g., 14.5 × 640 → 14 × 640 → 10 × 640 = 6,400; 4 × 640 = 2,560; subtotal = 8,960; 0.5 × 640 = 320; total = 9,280). Do not rely on mental math for multi-digit operations.
4. Present — output the estimate with:

• Assumptions block (see Disambiguation Protocol in shared.md) — listed before cost numbers
• Line items : service, unit price, quantity/hours, monthly cost
• Grand total : re-sum all line-item monthly costs independently; if discrepancy, use re-summed value

Post-Estimate Iteration

After presenting the estimate, the user may request changes (switch region, add RI, resize instances, add/remove services). Re-run only the affected queries — do not restart the full workflow.

Reference Index (load on demand)

Critical Rules

1. Never guess prices — always run the script against the live API
2. Infer currency and region from user context — if unspecified, ask the user or default to USD and eastus
3. Ask before assuming — if a required parameter is ambiguous or missing (tier, SKU, quantity, currency, node count, traffic volume), stop and ask the user. At the request level, clarify vague inputs (Step 2). At the parameter level, apply the Disambiguation Protocol (Step 5).
4. Default output format is Json — never use Summary (invisible to agents)
5. Lazy-load service references — only read files from references/services/ directly required by the user's query. Use the file-search workflow (Step 2) to locate specific files.
6. PowerShell: use-File, not -Command — run scripts with pwsh -File or powershell.exe -File; on Linux/macOS, bash strips OData quotes from inline commands. PS 5.1 caveat: use -Command instead of when passing array parameters (e.g., ), because mode does not parse PowerShell expression syntax and collapses the array into a single string.

Service File Metadata

YAML front matter fields. Optional fields use default elision — omitted means the default applies.

Universal Traps

These apply to EVERY query:

1. serviceName and all filter values are case-sensitive — use exact values from service reference files
2. Unfiltered queries return mixed SKU variants — always filter with productName/skuName to the specific variant needed
3. Multi-meter resources need separate queries — run one query per meter with -MeterName

Batch Estimation Mode

When estimating 3 or more services , use these rules to reduce token consumption:

1. Partial reads — read only lines 1–45 of each service file (YAML front matter, trap, first query pattern).
2. Front matter routing — use YAML metadata to skip unnecessary work:
   • hasMeters: false / pricingRegion: api-unavailable → skip API; use Known Rates or primaryCost
   • pricingRegion: global → Region: Global; empty-region → omit region
   • apiServiceName → use instead of serviceName in queries
   • hasFreeGrant: true → apply grant deduction; → add PE line item

Weekly Installs

80

Repository

ahmadabdalla/az…or-skill

GitHub Stars

12

First Seen

Feb 9, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

github-copilot79

opencode77

codex77

gemini-cli77

kimi-cli76

amp76