gpu-use

Diagnose remote GPU usage via SSH with per-GPU memory and process reports.

258|26|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/majiayu000/spellbook --skill gpu-use
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpu-use
Source: https://github.com/majiayu000/spellbook/tree/main/skills/gpu-use
Command: npx skills add https://github.com/majiayu000/spellbook --skill gpu-use

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables quick visibility into remote GPU usage by SSH-ing into a server and presenting per-GPU memory usage, running processes, and the containers those processes belong to.

Core Features & Use Cases

  • Remote data collection: fetch per-GPU memory, utilization, and process lists via SSH using nvidia-smi and docker commands.
  • Process-to-container mapping: correlate PIDs with container names for clear attribution.
  • Flexible targets: allow custom SSH targets or use a default server alias for convenience.
  • Readable reporting: generate a concise, structured view of GPU resources and activity.

Quick Start

SSH into the target server and run the GPU usage diagnostic to display per-GPU memory, running processes, and container mappings.

Frequently Asked Questions about gpu-use

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor remote GPU usage and running processes via SSH?

Monitor remote GPU usage by SSH-ing into the target server to collect per-GPU memory, utilization, and running processes. It coordinates nvidia-smi and docker commands to generate a readable report of GPU activity.

Can I map running GPU processes to their Docker containers on a remote server?

Yes, you can map running GPU processes to Docker containers on a remote server. It correlates PIDs from nvidia-smi with container names via SSH, providing clear attribution for active processes across hosts.

What do I need to check remote GPU usage with nvidia-smi and docker commands?

To check remote GPU usage, you need Bash as an allowed tool and SSH readiness to the target server. This allows you to execute nvidia-smi and docker commands for data collection and process-to-container mapping.

How does remote GPU diagnostics work for identifying memory bottlenecks in containers?

Remote GPU diagnostics works by collecting per-GPU memory, utilization, and process lists via SSH. It maps processes to container names to identify memory bottlenecks and active processes across server clusters.

Can I use a custom SSH target to diagnose GPU utilization on different hosts?

Yes, you can use a custom SSH target to diagnose GPU utilization on different hosts. It allows specifying custom SSH targets or using a default server alias for flexible remote monitoring.

What is the best way to get a structured report of GPU resources and activity across a cluster?

The best way to get a structured report of GPU resources is by running a GPU usage diagnostic via SSH. It fetches memory, utilization, and process-to-container mappings to generate a concise view of cluster activity.