Skip to main content
skill CX Codex

runai-get-cluster-health-summary — Claude Code skill

runai-get-cluster-health-summary is a Claude Code skill that checks Run:ai cluster and node health, gives each pool a verdict, and identifies its main blocker. It shows why a pool won't schedule.

no license ★ 4,106 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NVIDIA/skills --skill runai-get-cluster-health-summary -a claude-code
Open on GitHub

What runai-get-cluster-health-summary does

The skill takes a snapshot of cluster state via Run:ai MCP and delivers one verdict per pool plus a cluster-wide summary. It detects unready nodes, GPU allocation and free capacity, resource mismatches, pool saturation, and scheduler stalls—and tells the difference between a full pool and a broken scheduler. This is the entry point for ops triage.

Read-only by design: never restarts nodes, deletes pods, or changes quotas. Requires Run:ai MCP server with access to pools, node health, cluster inventory, and metrics. No Kubernetes fallback—without MCP, it stops.

Not for quota audits, GPU waste by project, single-workload diagnosis, or failure history. Related skills handle those: runai-audit-assigned-quota, runai-get-utilization-overview, and runai-diagnose-failed-workload.

What it helps with

  • check whether a Run:ai cluster is healthy right now
  • find out why a node pool stopped scheduling new workloads
  • detect offline or failing GPU nodes
  • see free GPU capacity at a glance
  • distinguish a saturated pool from a stuck scheduler

Example prompts for the agent

  • Show cluster health for prod-us-west, breakdown by pool
  • Why isn't gpu-a100 scheduling? We have pending workloads piling up
  • How many GPUs are free? Which nodes are NotReady?

How to install runai-get-cluster-health-summary

1Skills CLI (Vercel)

npx skills add NVIDIA/skills --skill runai-get-cluster-health-summary -a claude-code

2Manually: put the files in place

~/.claude/skills/runai-get-cluster-health-summary/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/runai-get-cluster-health-summary/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about runai-get-cluster-health-summary

How do I install runai-get-cluster-health-summary in Claude Code?

Run npx skills add NVIDIA/skills --skill runai-get-cluster-health-summary -a claude-code, then open ~/.claude/skills/runai-get-cluster-health-summary/SKILL.md.

What does runai-get-cluster-health-summary do?

It snapshots your Run:ai cluster state: for each pool, it reports HEALTHY, DEGRADED, or STUCK, and names the blocker—unready nodes, failed GPUs, saturation, or scheduler stall.

Do I need kubectl or Kubernetes access?

No. The skill reads only through Run:ai MCP. If MCP is unavailable, it stops without falling back to kubectl.

Similar skills

All skills for DevOps and infrastructure →

From the same set312

The whole set →
cdf-defect-image-generation cdf-defect-image-generation produces synthetic solder-defect images for board inspection via a DAG in CDF Orchestration. Useful when rare defects need volume without manual annotation. CX Codex +1 ★ 4,106repo stars paidf-cosmos-predict paidf-cosmos-predict prepares PAIDF config and runs Cosmos Predict video generation for DEFT media samples, finishing with a JSONL map from each input id to its clip. CX Codex +1 ★ 4,106repo stars doca-urom-svc doca-urom-svc guides configuration and operations for the DOCA UROM Service container on BlueField Arm to offload host remote memory tasks. CX Codex +1 ★ 4,106repo stars cdf-curation-and-retrieval The cdf-curation-and-retrieval skill guides video and image curation with Cosmos Curator, plus handoffs to TAO and searches through Cosmos Dataset Search. Use it for requests involving CDF or its Make and CLI workflows. CX Codex +1 ★ 4,106repo stars warp-debug-gradients warp-debug-gradients diagnoses broken gradients, diverging loss, and silent autodiff bugs inside differentiable NVIDIA Warp programs. CX Codex +1 ★ 4,106repo stars tao-train-codetr The tao-train-codetr skill guides Co-DETR training, evaluation, and inference in TAO. Use it to run object detection with COCO data or an image folder. CX Codex +1 ★ 4,106repo stars isaac-mission-control-showcase isaac-mission-control-showcase launches a local Nova Carter simulation in Isaac Sim with Mission Control driving it. Use for demos, scenario testing, and small-warehouse integration diagnostics. CX Codex +1 ★ 4,106repo stars i4h-workflow-scene-edit i4h-workflow-scene-edit edits existing Isaac for Healthcare workflow scenes and task contracts in a live Isaac Sim session without modifying files until instructed to bake. CX Codex +1 ★ 4,106repo stars

Project sponsors

Companies that keep this analytics open