Agent skill · research science · nvidia
cudaq-guide
Use for CUDA-Q setup, simulation targets, QPU access, and @cudaq.kernel authoring guidance.
Why this skill is useful
Provides domain-specific knowledge on CUDA-Q installation, usage, and quantum programming patterns that the AI wouldn't reliably generate on its own.
What it needs
Requires cuda-toolkit installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 2,816 stars on the source repository.
What this skill does
CUDA-Q Guide Purpose Guide users through CUDA-Q installation, basic kernels, GPU simulation targets, QPU access, built-in applications, multi-GPU execution, and Python @cudaq.kernel authoring. For Qiskit-to-CUDA-Q ports, route to the cudaq-importing skill instead. Prerequisites Python 3.10+ for Python CUDA-Q workflows. CUDA Toolkit and an NVIDIA GPU for GPU-accelerated targets on Linux. CPU-only simulation is available through qpp-cpu; macOS is CPU-only. C++ workflows require Linux or WSL and C++20. QPU workflows require provider-specific credentials and accounts. Instructions Invoke with /cudaq-guide [argument]. If no argument is given, display the onboarding menu and ask which topic the user wants. Use the routing table below to choose the relevant reference file. Read local CUDA-Q documentation files when the answer depends on a specific CUDA-Q version or backend behavior. Do not answer Qiskit porting questions from this skill; use cudaq-importing. Routing by Argument Argument Action Reference --- --- --- install Walk through Python or C++ installation and validation. references/onboarding.md test-program Build and run a Bell-state kernel. references/onboarding.md gpu-sim Select GPU, multi-GPU, tensor-network, or CPU targets. references/onboarding.md qpu Guide provider selection and credential-safe QPU setup. references/onboarding.md applications Summarize CUDA-Q application areas and notebooks. references/onboarding.md parallelize Choose mgpu, mqpu, async dispatch, or distributed observe. references/onboarding.md author Author CUDA-Q Python kernels, select execution APIs, and debug compiler issues. references/authoring.md (none) Print the menu below and ask which topic to explore. This file Menu Reference Files references/onboarding.md: installation, test program, GPU targets, QPU providers, application areas, parallelization modes, examples, and platform troubleshooting. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nvidia/cudaq-guide