Skip to content

Robertjam954/multimodal_rag_application / .claude/skills/azure-compute

azure-compute

Flagged

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine learning, HPC simulation, dev/test, workload, family, load balancer, Flexible orchestration, Uniform orchestration, cost estimate, can't connect / RDP / SSH, refused, black screen, reset password, reach VM, port 3389, NSG, security, Linux, troubleshoot, troubleshooting, connectivity, capacity reservation (CRG), reserve, guarantee capacity, pre-provision, CRG association, CRG disassociation, machine enrollment (EMM), Essential Machine Management, monitor. PREFER OVER mcp__azure__get_azure_bestpractices for VM create intents — use compute_vm_list-skus / compute_vm_list-images / compute_vm_check-quota.

FileKindSize
SKILL.mdskill md3.2 KB
references/retail-prices-api.mdmarkdown6.3 KB
references/vm-families.mdmarkdown5.8 KB
references/vm-quotas.mdmarkdown4.1 KB
references/vmss-guide.mdmarkdown6.2 KB
workflows/capacity-reservation/capacity-reservation.mdmarkdown7.8 KB
workflows/capacity-reservation/references/association-disassociation.mdmarkdown3.8 KB
workflows/capacity-reservation/references/capacity-reservation-overview.mdmarkdown6.0 KB
workflows/essential-machine-management/essential-machine-management.mdmarkdown5.0 KB
workflows/essential-machine-management/references/emm-enable-flow-portal-guidance.mdmarkdown3.1 KB
workflows/essential-machine-management/references/emm-enable-flow.mdmarkdown9.2 KB
workflows/essential-machine-management/references/emm-overview.mdmarkdown2.4 KB
workflows/essential-machine-management/references/emm-prerequisites.mdmarkdown3.5 KB
workflows/vm-creator/examples/bicep/README.mdmarkdown1.6 KB
workflows/vm-creator/examples/bicep/main.bicepother3.8 KB
workflows/vm-creator/examples/terraform/README.mdmarkdown2.5 KB
workflows/vm-creator/examples/terraform/main.tfother3.2 KB
workflows/vm-creator/examples/terraform/outputs.tfother135 B
workflows/vm-creator/examples/terraform/variables.tfother1010 B
workflows/vm-creator/references/delivery-options/github-pr.mdmarkdown3.2 KB
workflows/vm-creator/references/delivery-options/index.mdmarkdown2.3 KB
workflows/vm-creator/references/delivery-options/print.mdmarkdown474 B
workflows/vm-creator/references/delivery-options/save-local.mdmarkdown2.0 KB
workflows/vm-creator/references/depth-probe/beginner.mdmarkdown1.2 KB
workflows/vm-creator/references/depth-probe/cost-deep.mdmarkdown1.1 KB
workflows/vm-creator/references/depth-probe/index.mdmarkdown3.0 KB
workflows/vm-creator/references/depth-probe/networking-deep.mdmarkdown1.6 KB
workflows/vm-creator/references/depth-probe/security-deep.mdmarkdown1.2 KB
workflows/vm-creator/references/depth-probe/spec-deep.mdmarkdown1.3 KB
workflows/vm-creator/references/mcp-tools.mdmarkdown2.3 KB
workflows/vm-creator/references/output-adapters/az-cli.mdmarkdown1.9 KB
workflows/vm-creator/references/output-adapters/bicep.mdmarkdown1.7 KB
workflows/vm-creator/references/output-adapters/index.mdmarkdown3.0 KB
workflows/vm-creator/references/output-adapters/mcp-apply.mdmarkdown2.6 KB
workflows/vm-creator/references/output-adapters/terraform.mdmarkdown1.5 KB
workflows/vm-creator/references/plan-card.mdmarkdown3.9 KB
workflows/vm-creator/references/validation-gates.mdmarkdown2.2 KB
workflows/vm-creator/vm-creator.mdmarkdown7.6 KB
workflows/vm-recommender/references/handoff-to-creator.mdmarkdown1.6 KB
workflows/vm-recommender/references/web-fetch-policy.mdmarkdown1.6 KB
workflows/vm-recommender/vm-recommender.mdmarkdown6.4 KB
workflows/vm-troubleshooter/references/cannot-connect-to-vm.mdmarkdown5.7 KB
workflows/vm-troubleshooter/references/credential-auth-errors.mdmarkdown5.8 KB
workflows/vm-troubleshooter/references/firewall-blocking.mdmarkdown4.8 KB
workflows/vm-troubleshooter/references/network-connectivity.mdmarkdown4.7 KB
workflows/vm-troubleshooter/references/rdp-connectivity.mdmarkdown6.9 KB
workflows/vm-troubleshooter/references/rdp-service-config.mdmarkdown3.2 KB
workflows/vm-troubleshooter/references/ssh-connectivity.mdmarkdown5.4 KB
workflows/vm-troubleshooter/references/vm-agent-not-responding.mdmarkdown3.6 KB
workflows/vm-troubleshooter/vm-troubleshooter.mdmarkdown9.8 KB

workflows/vm-recommender/vm-recommender.md

View on GitHub
# Azure VM Recommender

Recommend Azure VM sizes, VM Scale Sets (VMSS), and configurations by analyzing workload type, performance requirements, scaling needs, and budget. No Azure subscription required — data comes from public Microsoft documentation and the unauthenticated Retail Prices API.

## When to Use This Skill

- User asks which Azure VM or VMSS to choose for a workload
- User wants to compare VM families, sizes, or pricing tiers
- User asks about trade-offs (cost vs performance, single VM vs scale set, orchestration modes)
- User needs a cost estimate without an Azure subscription
- User asks "Needs autoscaling?" or wants to decide between a single VM and a scale set

## Workflow

> Use reference files for initial filtering. Then **verify with live documentation** via `web_fetch` before final recommendations. If `web_fetch` fails, fall back to the reference files and surface the staleness warning from [web-fetch-policy.md](references/web-fetch-policy.md).

### Step 1: Gather Requirements

Ask the user (infer when possible):

| Requirement | Examples |
|---|---|
| Workload type | Web server, relational DB, ML training, batch, dev/test |
| vCPU / RAM needs | "4 cores, 16 GB" or "lightweight" / "heavy" |
| GPU needed? | Yes → GPU families; No → general / compute / memory |
| Storage needs | High IOPS, large temp disk, premium SSD |
| Budget priority | Cost-sensitive, performance-first, balanced |
| OS | Linux or Windows (affects pricing) |
| Region | Affects availability and price |
| Instance count | Single, fixed count, or variable |
| Scaling needs | None, manual, autoscale (metrics / schedule) |
| Availability needs | Best-effort, fault-domain, cross-zone HA |
| Load balancing | None, Azure Load Balancer (L4), Application Gateway (L7) |

### Step 2: Determine VM vs VMSS

Review [VMSS Guide](../../references/vmss-guide.md). Decision shortcut — start by asking **Needs autoscaling?** then walk the table:

| Signal | Pick |
|---|---|
| Autoscale on CPU, memory, or schedule | **VMSS** |
| Stateless web/API tier behind a load balancer | **VMSS** |
| Batch / parallel processing across many nodes | **VMSS** |
| Mixed VM sizes in one group | **VMSS (Flexible)** |
| Single long-lived server (jumpbox, AD DC) | **VM** |
| Unique per-instance config | **VM** |
| Stateful, tightly-coupled cluster | **VM** (or VMSS case-by-case) |

If recommending VMSS, verify with `web_fetch` per [web-fetch-policy.md](references/web-fetch-policy.md). When in doubt, default to a single **VM**.

### Step 3: Select VM Family

Review [VM Family Guide](../../references/vm-families.md) and pick 2–3 candidate families. Verify each candidate's specs with `web_fetch` against:

```
https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/<family-category>/<series-name>
```

For Spot eligibility, also fetch `https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/use-spot`. If any fetch fails, follow [web-fetch-policy.md](references/web-fetch-policy.md). Same SKUs apply to single VMs and VMSS.

### Step 4: Look Up Pricing

Query the Azure Retail Prices API per [Retail Prices API Guide](../../references/retail-prices-api.md).

> **VMSS:** no extra charge — pricing is per-VM. Multiply per-instance price × expected count. For autoscale, estimate at both `min` and `max`.

### Step 5: Validate Quota Availability

> **GATE — do not present recommendations until quota is validated.**

If the user has a subscription + region, review and run the checks from [VM Quota Validation Guide](../../references/vm-quotas.md). Without a subscription, note quota must be checked before deployment.

| Outcome | Action |
|---|---|
| ✅ Sufficient | Proceed to Step 6 |
| ⚠️ Near limit (>80%) | Proceed but warn; suggest quota increase |
| ❌ Insufficient | Request increase, swap family, or try another region |

Include a "Quota Status" column (✅/⚠️/❌) in the table.

### Step 6: Present Recommendations

Provide **2–3 options** with trade-offs:

| Column | Purpose |
|---|---|
| Hosting Model | VM or VMSS (with orchestration mode if VMSS) |
| VM Size | ARM SKU name (e.g., `Standard_D4s_v5`) |
| vCPUs / RAM | Core specs |
| Instance Count | `1` for VM; `min–max` for VMSS with autoscale |
| Estimated $/hr | Per-instance pay-as-you-go |
| Why | Workload fit |
| Trade-off | What the user gives up |

Always explain *why* a family fits and the Trade-off (cost vs cores, burstable vs dedicated, VM simplicity vs VMSS scale).

For VMSS, also mention orchestration mode (default **Flexible**), autoscale strategy (metric / schedule / both), and load balancer type.

### Step 7: Offer Next Steps

- Compare reservation / savings plan pricing (`priceType eq 'Reservation'` in the API)
- Suggest [Azure Pricing Calculator](https://azure.microsoft.com/pricing/calculator/) for full estimates
- For VMSS: [autoscale best practices](https://learn.microsoft.com/azure/azure-monitor/autoscale/autoscale-best-practices), [VMSS networking](https://learn.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-networking)

### Step 8: Hand Off to VM Creator (Optional)

If the user wants to **actually provision** what was recommended, hand off to [vm-creator](../vm-creator/vm-creator.md). See [handoff-to-creator.md](references/handoff-to-creator.md) for the required Plan Card render and routing rules.

## Error Handling

| Scenario | Action |
|---|---|
| API returns empty results | Broaden filters — check `armRegionName`, `serviceName`, `armSkuName` spelling |
| User unsure of workload type | Ask clarifying questions; default to General Purpose D-series |
| Region not specified | Use `eastus` as default; note prices vary by region |
| Unclear if VM or VMSS needed | Ask about scaling + instance count; default to single VM if still unsure |
| User asks VMSS pricing directly | Same VM pricing API; VMSS has no extra charge — multiply by instance count |

## References

- [VM Family Guide](../../references/vm-families.md) — family-to-workload mapping
- [Retail Prices API Guide](../../references/retail-prices-api.md) — query patterns, filters
- [VMSS Guide](../../references/vmss-guide.md) — when to use VMSS, orchestration, autoscale
- [VM Quota Validation Guide](../../references/vm-quotas.md) — vCPU checks, CLI commands
- [web-fetch-policy.md](references/web-fetch-policy.md) — fail-safe behavior for live docs lookups
- [handoff-to-creator.md](references/handoff-to-creator.md) — Step 8 hand-off rules
- [vm-creator](../vm-creator/vm-creator.md) — provision the recommended SKU
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall