Agent skill · nvidia
doca-ngauge
Use this skill when the operator is driving the DOCA ngauge tool to analyze, visualize, and debug network performance on a single node by probing NIC hardware counters and storing collected data in HDF5 format. Trigger even when the user does not say "DOCA ngauge" — implicit phrasings include "probe NIC hardware counters", "collect HDF5 performance data", "plot ngauge output", "sample counters on BlueField/ConnectX", "measure network performance on a single node", "debug network performance with hardware counters", "run ngauge YAML config", "parse ngauge HDF5 output". Refuse and route elsewhere: DOCA install/bring-up to doca-setup, version questions to doca-version, hardware/firmware state changes to doca-hardware-safety, raw packet I/O to doca-eth, and host-DPU messaging to doca-comch.
What it needs
About 8k tokens when loaded.
What this skill does
DOCA ngauge Scope boundaries These requests are out of scope: say so, name the skill that owns the request, and stop. raw Ethernet packet send/receive at line rate: doca-eth/SKILL.md. host-DPU control-plane messaging (Comch): doca-comch/SKILL.md. DOCA install and bring-up: doca-setup/SKILL.md. which DOCA version is installed, version compatibility: doca-version/SKILL.md. NIC or BlueField mode and firmware changes: doca-hardware-safety/SKILL.md. general DOCA orientation and documentation lookup: doca-public-knowledge-map/SKILL.md. Examples "Probe NIC hardware counters on a BlueField-3 and save HDF5 data." — this is in scope. Configure the YAML file and run ngauge; do not attempt to change hardware or firmware state here. "Plot the collected counter data from an ngauge output file." — use the sample plugins under /usr/share/doc/ngauge/examples/plugins; dependencies may need separate installation. "ngauge cannot start because fwctl is in use." — check for other tools or services that also use fwctl; route install and driver conflict resolution to doca-setup. Quick facts The authoritative source for the binary name, flags, paths, and configuration schema is the public DOCA ngauge guide at https://docs.nvidia.com/doca/archive/3-5-0/doca-ngauge/index.html. Confirm details with the installed tool's --help and the sample configuration files before quoting them. ngauge analyzes, visualizes, and debugs network performance on a single node by probing NIC hardware counters and storing collected data in HDF5 format with relevant metadata. Supported hardware: NVIDIA BlueField-3, NVIDIA ConnectX-7, and above; firmware version xx.43.1000 or higher. ngauge relies on the fwctl driver and cannot run simultaneously with other tools or services that also use fwctl. All configurations are defined in an input YAML file. Sample configuration files are under /usr/share/doc/ngauge/examples/settings. The device is specified by its PCIe address, for example device: "0000:03:00.0". …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nvidia/doca-ngauge