gpu-host-tuninglisted
Install: claude install-skill air-gapped/skills
# gpu-host-tuning
Host-side tuning + audit for Linux GPU inference servers. Sits *beneath* any
inference framework (vLLM, sglang, TensorRT-LLM, llama.cpp).
**Assumes a working host.** Driver, `nvidia-fabricmanager`, and NVLink/NVSwitch
must already be healthy — if `nvidia-smi` doesn't list every GPU, or
fabricmanager isn't `active (running)`, that is a bring-up problem, not a
tuning one: use `nvidia-datacenter-bringup` (same `inference-host` plugin)
first. Tuning a half-initialised host produces numbers that describe the fault,
not the hardware.
Three modes:
1. **Audit** — read-only snapshot
2. **Bench** — ground-truth pinned-host↔GPU memcpy ceiling
3. **Tune** — apply individual levers from the cheat-sheet
This file is a pointer map. The actual logic lives in `scripts/` and the
authoritative references in `references/`.
## Quick start
```bash
# From the skill directory — typically ~/.claude/skills/gpu-host-tuning
# (personal) or .claude/skills/gpu-host-tuning (project install).
# Audit (read-only, ~60s)
./scripts/collect.sh
# Audit + pinned-memcpy bench (needs torch + CUDA, ~5 min)
./scripts/collect.sh --bench
```
The script prompts for the output parent dir on first interactive run and
remembers the choice. Override via `--out <dir>` or `HOST_AUDIT_DIR=<dir>`.
Default snapshot dirname is `gpu-host-tuning-<host>-<UTC>`.
## What the snapshot captures
One file per probe, numbered by section. See
[`references/probe-interpretation.md`](references/probe-interpretation