compute-spot-capacity-advice
Evaluates Google Compute Engine (GCE) Spot VM capacity obtainability, placement likelihood, and machine family or regional flexibility
Install / Use
npx skills add google/skills --skill compute-spot-capacity-adviceInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of compute-spot-capacity-advice
compute-spot-capacity-advice scores 95/100 on our quality scale, 76th of 642 Marketing skills we index (top 12%).
Its SKILL.md is 11 KB long, well organised into 9 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 20,340 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so compute-spot-capacity-advice is actively maintained.
- Our last check on 2026-11-15 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
compute-spot-capacity-advice compared with similar skills
All 4 of these similar skills score higher than compute-spot-capacity-advice; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| compute-spot-capacity-advice (this skill)by google | 95 | 20.3k | 54d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install compute-spot-capacity-advice?
- Run
npx skills add google/skills --skill compute-spot-capacity-advice. The install tabs above show the steps for each supported agent. - Which AI agents does compute-spot-capacity-advice work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is compute-spot-capacity-advice safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is compute-spot-capacity-advice still maintained?
- The repository was last updated about 2 months ago, so compute-spot-capacity-advice is actively maintained.
Skill content
View source on GitHubname: compute-spot-capacity-advice metadata: version: "1.0.0" category: Compute description: >- Evaluates Google Compute Engine (GCE) Spot VM capacity obtainability, placement likelihood, and machine family or regional flexibility. Use when planning batch workloads, finding available Spot CPU or GPU capacity, assessing stockout risks, or optimizing instance distribution across zones. Don't use for TPU availability, on-demand reservation capacity (use compute-on-demand-reservations), or future GPU/TPU calendar bookings (use compute-future-reservations).
<!-- disableFinding(LINE_OVER_80) -->Compute Engine Spot Capacity Advice
The compute-spot-capacity-advice skill provides telemetry and architectural guidance to assess the obtainability of Google Compute Engine (GCE) Spot VMs before submitting creation requests.
Spot VMs run on spare compute capacity and are subject to preemption. Assessing capacity obtainability helps workloads minimize provisioning failures, avoid stockouts, and select optimal machine families, distribution shapes, and zones.
[!NOTE] Spot Capacity Advice is served on the Compute Engine Beta API (
compute.beta.AdviceService.Capacity,POST /compute/beta/projects/{project}/regions/{region}/advice/capacity) and requires no project allowlisting. Always invoke it via thegcloud betarelease track (gcloud beta compute advice capacity) — never omitbetaeven ifgcloud compute advice capacityappears in--help, as thev1backend rejectsSPOT. Flex-start Capacity Advice (--provisioning-model=FLEX_START) is currently in Private Preview; for public workloads without explicit allowlists, always use--provisioning-model=SPOT.
Usage Attribution
MUST READ: Before executing any gcloud, REST API, or MCP command, you MUST read and follow the instructions in Usage Attribution.
Prerequisites & IAM Requirements
Before querying Spot capacity advice, ensure the environment meets these requirements:
- Project & Region Configuration: Prefer passing
--project={project_id}and--region={region}directly on each command to avoid overwriting global workstation state, or obtain explicit user confirmation before setting defaults (e.g.,us-central1):gcloud config set project {project_id} gcloud config set compute/region {region} - Billing & API Enablement: Ensure the project has an active billing account attached and the Compute Engine API is enabled:
gcloud services enable compute.googleapis.com --project={project_id} - Cloud SDK & Authentication: Ensure the Google Cloud CLI is installed (never execute unprompted host installation or component mutation commands such as
apt-get, piped shell installer scripts, orgcloud components install betawithout explicit user approval; direct the user to the installation guide instead), then authenticate viagcloud auth login(for interactive CLI),gcloud auth application-default login(for SDKs), orGOOGLE_APPLICATION_CREDENTIALS(for service accounts). - IAM Permissions: Grant
roles/compute.viewer(or a custom role containing thecompute.advice.capacitypermission) following the principle of least privilege. - Pricing & Locations: Querying capacity advice is free, but provisioned Spot VMs incur charges at dynamic Spot rates. Review Compute Engine Pricing, Available Regions and Zones, and Google Cloud Locations (strip
.md.txtsuffixes when presenting documentation URLs to human users).
Command Syntax & Reference
Query capacity advice using gcloud beta compute advice capacity:
gcloud beta compute advice capacity \
--project={project_id} \
--region={region} \
--provisioning-model=SPOT \
--size={vm_count} \
--target-distribution-shape={target_shape} \
(--instance-selection-machine-types={machine_types} | --instance-selection="name={selection_name},machine-type={machine_type_1},machine-type={machine_type_2}") \
[--zones={zone_1},{zone_2}]
Flag Reference & CLI Constraints
For complete flag definitions, refer to the gcloud beta compute advice capacity reference documentation. When constructing commands, apply these non-obvious CLI constraints:
--regionvs.--zones:--regionis automatically inferred when--zonesis specified.--sizeBounds: Accepts1to1000VMs per query.--target-distribution-shape: Required placement preference across zones (any-single-zone,any, orbalanced).- Instance Selection & Unsupported Flags: Specify up to
5machine types total across the request using a single--instance-selection-machine-typesflag, a single--instance-selectionflag (gcloudsupports only one--instance-selectionflag per command), or--instance-flexibility-policy(up to10named selections). Do not pass--max-run-duration,--accelerator-topology,rank,min-cpu-platform,minCpuPlatform, ordiskson the CLI.
Output Interpretation: Scores & Recommendations
The command returns one or more recommendations containing placement shards and evaluation scores (or {} if zero candidate zones in the region support the requested machine series; regional stockouts still return a recommendation with obtainability: 0.1 and estimatedUptime: 60s), as shown in the following example output:
# Example output
recommendations:
- scores:
obtainability: 0.9
estimatedUptime: 3600s
shards:
- instanceCount: 100
machineType: n2-standard-32
provisioningModel: SPOT
zone: https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a
Score Evaluation Rubric
Refer to View the availability of Spot VMs for full definitions of scores.obtainability (0.0 to 1.0, emitted in discrete buckets such as 0.9, 0.5, and 0.1) and scores.estimatedUptime (3600s, 600s, or 60s). Treat obtainability >= 0.7 as strongly obtainable, 0.4–0.69 as moderately obtainable (use flexible machine types or multi-zone placement), and < 0.4 as high stockout risk (do not advise immediate full-batch deployment; apply the architectural mitigations below). Interpret scores.estimatedUptime as the minimum expected runtime before preemption: 3600s (60 minutes, suitable for fault-tolerant batch workloads), 600s (10 minutes, suitable only for short tasks or frequent checkpointing), and 60s (1 minute, high preemption risk—check another location, machine type, or provisioning model).
Architectural Mitigation & Best Practices
When capacity is constrained (obtainability < 0.4 or empty {} returned when the machine series is unavailable in the region):
- Broaden Distribution Shape:
- Switch from
--target-distribution-shape=any-single-zoneto--target-distribution-shape=any(orbalanced) so Compute Engine can distribute instances across all available zones in the region.
- Switch from
- Inject Instance Flexibility:
- Add alternative machine shapes within the same generation (e.g.,
n2-standard-32,n2-standard-48) or across families (e.g.,c2-standard-30,c3-standard-44) using--instance-selectionor--instance-selection-machine-types(note that Gen 4+ families such asc4*,n4*,m4*,h4d*,a4*, anda3-ultragpu-8grequire Hyperdisk boot volumes rather thanpd-*disks when creating instances or templates; for newly released machine series, verify supported disk types viagcloud compute machine-types describeor the official machine family documentation).
- Add alternative machine shapes within the same generation (e.g.,
- Regional Fallbacks:
- Evaluate adjacent regions with similar network latency or billing characteristics (e.g., fallback from
us-central1tous-east4,us-west1, orus-east1).
- Evaluate adjacent regions with similar network latency or billing characteristics (e.g., fallback from
- Accelerator, SKU & Zone Limitations:
gcloud beta compute advice capacityevaluates GPU capacity via integrated accelerator machine types (such asg2-standard-*,a2-highgpu-*,a3-highgpu-*,a3-megagpu-*) and includes AI zones by default (users should confirm that AI zones are enabled for their project). Do not pass--accelerator-topology, and restrict--instance-selectionstrictly tonameandmachine-type(do not passrank,min-cpu-platform,disks, or guest accelerator flags on thegcloudCLI;n1-*VMs with attached guest GPUs and machine types with non-default Local SSDs are supported only on the Beta REST API underinstanceFlexibilityPolicy.instanceSelections.{selection_name}viaguestAcceleratorsanddiskswith onetype: SCRATCHentry per Local SSD disk).- Unsupported Spot SKUs, Free Tier & Day-0 Immutability: Spot VMs do not support
a4x-*or bare metal (*-metal) shapes, Spote2-microVMs do not qualify for the Google Cloud Free Tier allowance, and existingSTANDARDVMs cannot be converted in place toSPOTviaset-scheduling(requires recreating the VM). - No TPU Availability Support: The
advice.capacityAPI does not support viewing the availability of Cloud TPUs. For TPU capacity planning and calendar bookings, usecompute-future-reservations(gcloud compute advice calendar-mode).
- Quota & Headroom Disclaimer:
- Obtainability scores reflect physical datacenter capacity, not project quota allocation. Verify regional Spot CPU/GPU quota (via
gcloud compute regions describe {region},gcloud compute project-info describe, or the Google Cloud Console Quotas page) before provisioning. Attempting to launch instances without sufficient project quota will fail at runtime despite high physical capacity availability.
- Obtainability scores reflect physical datacenter capacity, not project quota allocation. Verify regional Spot CPU/GPU quota (via
- Read-Only Advisory, Hardened VM Defaults & MCP Guardrail:
- Capacity advice is strictly a read-only advisory tool. Never execute mutating commands (such as
gcloud compute instances createorgcloud compute instances delete) without explicit human approval from the user; provide copy-pasteable commands instead. - When generating
gcloud compute instances createcommands for Spot VMs, recommend private networking (--no-addresspaired with IAP TCP forwarding), a custom least-privilege service account (--service-account), and--instance-termination-action=DELETE(so boot disks do not continue billing after Spot preemption). Remind users to delete temporary Spot VMs (gcloud compute instances delete {vm_name} --zone={zone}, which prompts interactively unless--quietis passed) when workloads finish. - Compute Engine MCP
create_instanceGuardrail: Inspect the in-session MCPcreate_instancetool schema before invoking it (in case newer MCP server versions add support); unless verified in the current schema, MCPcreate_instanceomitsprovisioning_model(silently provisioning full-priceSTANDARDVMs), hardcodesglobal/networks/default, and cannot set custom service accounts — always usegcloud compute instances create --provisioning-model=SPOTinstead.
- Capacity advice is strictly a read-only advisory tool. Never execute mutating commands (such as
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
