Diagnoses wrong gradients in differentiable NVIDIA Warp programs by measuring first — comparing autodiff against finite differences on a shrunk reproduction before proposing any fix.
NVIDIA CUDA-Q Onboarding Skill
NVIDIA's official onboarding skill for CUDA-Q — installs the platform, writes your first quantum kernel, picks a GPU simulator and routes you to real QPU hardware.
Install
Other ways to install
About
- Routes to install, test program, GPU simulation, QPU or applications from one command
- Validates a fresh install with a Bell state kernel instead of assuming success
- Picks between qpp-cpu, the nvidia target, mgpu memory pooling and mqpu circuit batching
- Shows async circuit dispatch with sample_async / observe_async across virtual QPUs
- Distributes large Hamiltonians with cudaq.parallel.thread or cudaq.parallel.mpi
- States the restricted-Python kernel subset and platform limits up front
An official, NVIDIA-authored agent skill that turns a coding agent into a CUDA-Q guide. CUDA-Q is NVIDIA's hybrid quantum-classical programming platform, and the usual failure mode for newcomers is not the physics — it is picking the wrong backend, writing kernel code the compiler rejects, or burning hours on a multi-GPU option that solves a different problem than the one they have.
What it teaches the agent
- A routing table instead of a wall of docs. Invoked as
/cudaq-guide [topic], it jumps straight to install, first test program, GPU simulation, QPU hardware, built-in applications or parallelisation. With no argument it presents the menu and asks what you actually want. - Installation that ends in a verified result. The default path is
pip install cudaq, validated by building a Bell state kernel and checking the histogram comes out near{ 00:~500 11:~500 }rather than assuming the install worked. - Backend selection.
qpp-cpufor CPU-only work, thenvidiatarget for a single GPU, and a clear rule for the two multi-GPU strategies that are easy to confuse:--target-option mgpupools GPU memory when one circuit is too large for a single card, whilemqpumaps a virtual QPU per GPU so many independent circuits run in parallel viasample_async/observe_async. - Hamiltonian batching, where adding
execution=cudaq.parallel.thread(single node) orcudaq.parallel.mpi(multi-node) tocudaq.observedistributes terms across GPUs with no other code change. - A two-step QPU dialogue — technology first, then provider — before reading the matching hardware documentation, so credential setup is not guessed at.
Limitations it makes explicit
GPU simulation requires Linux on x86_64 or ARM64; macOS is CPU-only. The mgpu target needs MPI. Kernel bodies accept only a restricted Python subset, so NumPy and SciPy calls inside @cudaq.kernel will not compile. QPU access needs provider-specific credentials.
Requirements
Python 3.10+ for the Python path, C++20 and Linux or WSL for the C++ path, and the CUDA Toolkit for GPU-accelerated targets. An NVIDIA GPU is optional given the CPU simulator.
Installing it
Part of NVIDIA's agent-skills catalogue, mirrored daily from NVIDIA's product repositories. Install the whole set with npx skills add nvidia/skills, or just this one with npx skills add nvidia/skills --skill cudaq-guide --yes. Works with Claude Code, Codex, Cursor and any runtime following the Agent Skills standard. Apache-2.0.
Try it
Once installed, ask your agent something like:
"/cudaq-guide parallelize — I have 5,000 independent VQE circuits and four A100s. Should I use mgpu or mqpu, and what does the dispatch code look like?"
SKILL.md
The instructions your agent loads, as published by NVIDIA.
Related Skills
See all NVIDIA CUDA-Q Onboarding alternativesTurns a plain-language weather question into a working Earth2Studio inference script — picks the AI forecast model, a compatible data source, an IO backend, and the step count.
Skill: NVIDIA TAO RT-DETR
by NVIDIA
Trains, distils, quantises, evaluates, exports and runs inference for RT-DETR real-time object detection in NVIDIA TAO, routing training through AutoML hyperparameter search by default.
Skill: NVIDIA Holoscan SDK Setup
by NVIDIA
Inspects the host's hardware, OS, CUDA driver and existing tooling, recommends one Holoscan SDK install method with a reason, then hands off to the matching install skill.