runai-get-utilization-overview — Claude Code skill: GPU usage analysis
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.
no license ★ 4,106 updated 2026-10-23
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a claude-codeWhat runai-get-utilization-overview 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.
What it helps with
- 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 for the agent
- 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
How to install runai-get-utilization-overview
1Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a claude-code2Manually: put the files in place
~/.claude/skills/runai-get-utilization-overview/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/runai-get-utilization-overview/
1Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a codex2Manually: put the files in place
.agents/skills/runai-get-utilization-overview/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a cursor2Manually: put the files in place
.cursor/skills/runai-get-utilization-overview/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NVIDIA/skills skills/runai-get-utilization-overview2Manually: put the files in place
.github/skills/runai-get-utilization-overview/SKILL.md1Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a gemini-cli2Platform CLI
gemini skills install https://github.com/NVIDIA/skills --path skills/runai-get-utilization-overviewManually: put the files in place
.devin/skills/runai-get-utilization-overview/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about runai-get-utilization-overview
How do I install runai-get-utilization-overview in Claude Code?
Run npx skills add NVIDIA/skills --skill runai-get-utilization-overview -a claude-code, then open ~/.claude/skills/runai-get-utilization-overview/SKILL.md.
What does runai-get-utilization-overview do?
It inspects GPU allocation and usage on your Run:ai cluster. It shows which projects, departments, or node pools hold GPU capacity that isn't actually being used, and quantifies the wasted hours by utilization tier.
Can this skill stop idle workloads?
No—it only reads. It will identify which workloads are idle and consuming GPU hours without load, but stopping them requires a separate write-capable workflow or manual action.