gpu-host-tuning

Audit Linux GPU inference hosts for configuration gaps and performance bottlenecks.

5|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/air-gapped/skills --skill gpu-host-tuning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpu-host-tuning
Source: https://github.com/air-gapped/skills/tree/main/.claude/skills/gpu-host-tuning
Command: npx skills add https://github.com/air-gapped/skills --skill gpu-host-tuning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dmidecode, lshw, lscpu, nvidia-smi, dcgmi, ethtool, lspci, numactl, turbostat, dmesg, nvbandwidth, nvme, smartctl, lsblk, cpupower, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps operators audit and tune Linux GPU inference hosts to surface configuration gaps and optimize throughput across CPU, memory, PCIe, NICs, and NVIDIA GPUs.

Core Features & Use Cases

  • Read-only audit to surface misconfigurations and bottlenecks across CPU power states, kernel parameters, NUMA, PCIe, NICs, and GPUs.
  • Bench to measure pinned-host ↔ GPU memcpy ceilings and establish ground-truth baselines for KV offload paths.
  • Tune to apply a cheat-sheet of BIOS, kernel, driver, and NIC settings for production inference workloads.
  • Supports phase-driven flow: audit -> bench -> tune; generates INDEX.md and drift reports; supports multiple chassis (Dell XE9680/ XE9780) and DGX-like setups.

Quick Start

Run ./scripts/collect.sh to generate a baseline snapshot, review the resulting INDEX.md, and begin applying tunings from the cheat-sheet.

Frequently Asked Questions about gpu-host-tuning

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

FAQPage Schema
How do I audit a Linux GPU host for inference bottlenecks?

You can audit a Linux GPU inference host by running a read-only collection script to surface configuration gaps across CPU power states, NUMA topology, PCIe, NICs, and NVIDIA driver state. This generates a baseline snapshot and structured INDEX.md for review.

What is the best way to tune NVIDIA GPU deployments for peak inference?

The best way to tune NVIDIA GPU deployments is applying a cheat-sheet of BIOS, kernel, driver, and NIC settings specifically for production inference workloads. This follows a phase-driven flow of auditing, benching, and tuning to establish reproducible baselines.

Does GPU host tuning work on both bare-metal and cloud Linux deployments?

Yes, GPU host tuning applies to both bare-metal and cloud Linux deployments. It supports multiple chassis configurations including Dell XE9680, XE9780, and DGX-like setups, capturing structured probes to validate hardware state across diverse environments.

How do I measure pinned-host to GPU memcpy ceilings for KV offload?

You measure pinned-host to GPU memcpy ceilings by running bench scripts that establish ground-truth baselines for KV offload paths. This captures actual throughput metrics to validate memory bandwidth and identify performance limitations.

Why should I check PCIe topology and NUMA affinity before tuning GPU inference?

Checking PCIe topology and NUMA affinity is critical because misconfigurations across these subsystems create severe performance bottlenecks. Auditing them validates NVIDIA driver state and ensures CPU, memory, and GPU resources are correctly allocated for inference.

What Linux tools do I need to profile CPU power states and GPU bandwidth?

Profiling CPU power states and GPU bandwidth requires Linux tools like turbostat, cpupower, nvidia-smi, dcgmi, nvbandwidth, numactl, and lspci. These dependencies capture hardware telemetry to surface misconfigurations and validate driver state.