How do I install the Gke Np Stockout Analyzer skill?

Run npx skillmds@latest add samos123/gke-np-stockout-analyzer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gke Np Stockout Analyzer safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gke Np Stockout Analyzer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gke Np Stockout Analyzer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gke Np Stockout Analyzer?

samos123 (@samos123) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gke Np Stockout Analyzer by samos123

Name: Gke Np Stockout Analyzer
Rating: 4.5 (4 reviews)
Author: samos123

Gke Np Stockout Analyzer

Analyzes GKE nodepool stockout errors to determine if they are expected (insufficient capacity) or unexpected (fragmentation or race condition). Use this when investigating GKE nodepool creation failures due to lack of capacity.

samos123 Updated Sep 22, 2026

File contents

GKE Nodepool Stockout Analyzer

This skill helps investigate GKE nodepool creation failures caused by a "lack of capacity" in a compute reservation. It analyzes GKE logs and reservation metrics to generate a clean markdown report showing exact timestamps, reservation usage, and error messages.

Usage

Use the bundled analyze_stockouts.py script to run the analysis. It queries GKE audit logs for node pool creation failures (including repair and automatic retry events) and Cloud Monitoring for reservation capacity and scheduled chips.

Command:

python3 gke-np-stockout-analyzer/scripts/analyze_stockouts.py --project <PROJECT_ID> --nodepool-regex <NODEPOOL_REGEX> [--cluster <CLUSTER_NAME>] [--output-file <REPORT_PATH>]

Example:

python3 gke-np-stockout-analyzer/scripts/analyze_stockouts.py --project my-example-project --nodepool-regex "np-prefix-.*" --output-file report.md

How It Works

Find Errors: It searches Cloud Audit logs for CREATE_NODE_POOL or RepairNodePool operations that failed with GCE stockout/capacity constraints.
Resolve Nodepool Reservation Config: It locates the original creation logs for matching nodepools to cache their target reservation ID and zone configuration.
Query Time-Series Metrics: It queries GCM for compute.googleapis.com/instance/tpu/scheduled_chips filtered by the target reservation_id at each error timestamp to calculate the exact chips in use versus the total reserved chips.
Report Generation: Produces a beautiful, clean Markdown table mapping each stockout event to reservation utilization and the detailed error message.

Frequently asked questions