# runai-get-utilization-overview

runai-get-utilization-overview is a Claude Code skill that checks whether projects and departments on a Run:ai cluster are using allocated GPUs or leaving them idle, and ranks them by utilization.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 4106 repo stars
- Author: Run:ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NVIDIA/skills/tree/HEAD/skills/runai-get-utilization-overview/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/runai-get-utilization-overview

## What it does

This skill answers one question: are allocated GPUs actually in use for computing, or sitting idle. It reads and reports only—never stops workloads, changes quota, or modifies pools.

It sorts GPU holders (projects, departments, node pools) into three categories based on average and p95 utilization: well-used, underutilized, or idle. You choose any time window; the default is seven days. When you drill into a project, the skill lists which workloads within it are consuming GPU capacity without real load.

Requires the Run:ai MCP server with access to GPU metrics and cluster inventory. If metrics are incomplete, a holder shows as `UNKNOWN`. It does not assess quota fairness, cluster health, individual workload status, or trends across windows.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/runai-get-utilization-overview/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/runai-get-utilization-overview/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/runai-get-utilization-overview/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/runai-get-utilization-overview/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills skills/runai-get-utilization-overview
```

2. **Manually: put the files in place**
- File: `.github/skills/runai-get-utilization-overview/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/runai-get-utilization-overview
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/runai-get-utilization-overview/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NVIDIA/skills/tree/HEAD/skills/runai-get-utilization-overview/SKILL.md

## When to use it
- identify which projects hold GPUs but aren't computing on them
- measure how many GPU-hours go unused in a given period
- rank node pools by wasted idle GPU capacity
- list idle workloads within a specific project
- check overall cluster utilization and find free capacity

## Example prompts
- Show GPU utilization by project for the last week on cluster-prod
- Which department holds the most idle GPUs, and how many wasted hours over the past month?
- List workloads in the ml-team project and tell me which ones are underutilized

## Similar
- [huawei-cloud-cce-cluster-management](https://affpapa.org/en/nevibecode/skills/huawei-cloud-cce-cluster-management.md) — skill · 293 installs
- [pulumi-overview](https://affpapa.org/en/nevibecode/skills/pulumi-overview.md) — skill · 626 installs
- [gke-ai-troubleshooting-node-unresponsive-timeout](https://affpapa.org/en/nevibecode/skills/gke-ai-troubleshooting-node-unresponsive-timeout.md) — skill · 810 installs
- [digitalocean-compute](https://affpapa.org/en/nevibecode/skills/digitalocean-compute.md) — skill · 435 installs
- [llm-inference-scaling](https://affpapa.org/en/nevibecode/skills/llm-inference-scaling.md) — skill · 380 installs
- [gpu-kubernetes-operations](https://affpapa.org/en/nevibecode/skills/gpu-kubernetes-operations.md) — skill · 365 installs

From the same set: [nvidia/skills](https://affpapa.org/en/nevibecode/by/nvidia/skills.md) — 312 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
