Agent skill · google

gke-ai-troubleshooting-tpu-slice-mig-stuck-updating

Diagnose and resolve GKE TPU Dynamic Slice creation and JobSet scheduling failures blocked by underlying Compute Engine managed instance groups (MIGs) stuck in an updating or unstable state (isStable=False). Use when TPU slice creation fails with a SliceCreationFailed status reason, when JobSets remain stuck in pending, or when MIG status reflects isStable=False or versionTarget.isReached=False during TPU slice formation. Don't use for SliceCreationFailed causes unrelated to MIG stability (use gke-ai-troubleshooting-tpu-dynamic-slices-monitoring) or general pod scheduling failures unrelated to TPU slices.

What it needs

About 7k tokens when loaded.

What this skill does

Troubleshoot GKE TPU slice creation blocked by an unstable MIG This skill helps diagnose GKE TPU Dynamic Slice creation failures and JobSet scheduling delays when the Compute Engine managed instance groups (MIGs) that back the TPU node pool aren't stable (status.isStable: false). A SliceCreationFailed status reason means that slice creation failed because prerequisites weren't met (for example, required Compute Engine resources are missing) or preflight checks failed (see Use dynamic slicing with a custom scheduler). A MIG that is still creating, updating, or repairing instances is one cause to check. This skill checks the slice status first, then the stability of the backing MIGs. Attribution MUST READ: Before executing any gcloud, REST API, or MCP command, you MUST read Usage Attribution. For commands executed directly in the terminal (never in generated scripts, Terraform, or user code), prefix gcloud with CLOUDSDKMETRICSREQUESTATTRIBUTION="agent-skills/1.0 (skill:gke-ai-troubleshooting-tpu-slice-mig-stuck-updating)" and append agent-skills/1.0 (skill:gke-ai-troubleshooting-tpu-slice-mig-stuck-updating) to User-Agent headers. Prerequisites Google Cloud SDK & Tools: For installing and initializing gcloud (project selection and authentication) and enabling the GKE API, follow Before you begin. For installing kubectl and configuring cluster credentials, follow the "Install kubectl", "Install required plugins", and "Store cluster information for kubectl" sections of Install kubectl and configure cluster access. API Enablement & Billing: Verify that the project has an active Cloud Billing account. Enable APIs: container.googleapis.com, compute.googleapis.com, and logging.googleapis.com. Required IAM Roles: Logs Viewer (roles/logging.viewer): Inspect Cloud Audit Logs for MIG errors. Compute Viewer (roles/compute.viewer): Check MIG stability (isStable) and instance progress. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills google/gke-ai-troubleshooting-tpu-slice-mig-stuck-updating

View the source on GitHub

Browse the @skills marketplace