All skills
nvidia avatar

/cudaq-guide

@46293cb
by NVIDIA Corporationnvidia/skills3.5k stars
424

Use for CUDA-Q setup, simulation targets, QPU access, and @cudaq.kernel authoring guidance.

Use this Skill: https://skilld.dev/gh/nvidia/skills/cudaq-guide

This session only. Nothing lands on disk.

skill-card.md

≈987 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Description: <br>

Use for CUDA-Q setup, simulation targets, QPU access, and @cudaq.kernel authoring guidance. <br>

This skill is ready for commercial/non-commercial use. <br>

Owner

NVIDIA <br>

License/Terms of Use: <br>

Apache 2.0 <br>

Use Case: <br>

Developers and engineers use this skill for CUDA-Q quantum-classical programming setup, GPU and QPU simulation target selection, and Python @cudaq.kernel authoring guidance. <br>

Deployment Geography for Use: <br>

Global <br>

Requirements / Dependencies: <br>

Requires API Key or External Credential: [No] <br> Credential Type(s): [None] <br>

Do not include secrets in prompts/logs/output; use least-privilege credentials; rotate keys as appropriate. <br>

Known Risks and Mitigations: <br>

Risk: Review before execution as proposals could introduce incorrect or misleading guidance into skills. <br> Mitigation: Review and scan skill before deployment. <br>

Reference(s): <br>

Skill Output: <br>

Output Type(s): [Analysis, Configuration instructions] <br> Output Format: [Markdown with inline code blocks] <br> Output Parameters: [1D] <br> Other Properties Related to Output: [None] <br>

Evaluation Agents Used: <br>

  • Claude Code (aws/anthropic/bedrock-claude-opus-4-8) <br>
  • Codex (openai/openai/gpt-5.5) <br>

Evaluation Tasks: <br>

13 evaluation tasks (10 positive, 3 negative) with 3 attempts per task in isolated sandbox pods. <br>

Evaluation Metrics Used: <br>

Reported benchmark dimensions: <br>

  • Security: Checks for unsafe operations, secret leakage, and unauthorized access. <br>
  • Correctness: Checks final-answer correctness against the reference answer. <br>
  • Discoverability: Checks whether the expected skill was selected, decoys were avoided, and the workflow executed. <br>
  • Effectiveness: Checks whether the user's goal was achieved and the expected workflow behavior was followed. <br>
  • Efficiency: Checks tool-call productivity and token efficiency. <br>

Underlying evaluation signals used in this run: <br>

  • security: Unsafe operations, secret leakage, and unauthorized access. <br>
  • accuracy: Final-answer correctness against the reference answer. <br>
  • skill_execution: Whether the expected skill was selected and the workflow executed. <br>
  • goal_accuracy: Whether the user's goal was achieved. <br>
  • behavior_check: Whether the expected workflow behavior was followed. <br>
  • skill_efficiency: Tool-call productivity. <br>
  • token_efficiency: Actual uncached prompt plus completion token usage. <br>

Evaluation Results: <br>

Measure Claude Code (Baseline → Skill Uplift) Codex (Baseline → Skill Uplift)
Overall 93.6% 89.2%
Security 100.0% → 100.0% (±0.0 points) 85.7% → 92.3% (+6.6 points)
Correctness 92.3% → 98.5% (+6.2 points) 90.0% → 98.5% (+8.5 points)
Discoverability 97.5% 92.0%
Effectiveness 69.2% → 79.9% (+10.7 points) 66.0% → 86.1% (+20.1 points)
Efficiency 91.9% 77.1%

Skill Version(s): <br>

1.1.2 (source: frontmatter) <br>

Ethical Considerations: <br>

NVIDIA believes Trustworthy AI is a shared responsibility and we have established policies and practices to enable development for a wide array of AI applications. When downloaded or used in accordance with our terms of service, developers should work with their internal team to ensure this skill meets requirements for the relevant industry and use case and addresses unforeseen product misuse. <br>

(For Release on NVIDIA Platforms Only) <br> Please report quality, risk, security vulnerabilities or NVIDIA AI Concerns here. <br>

Source: SKILL.md on GitHub

No alerts19d3 checks · Risk SAFE
  • Gen Agent Trust Hub19d

    The cudaq-guide skill is an onboarding tool for the NVIDIA CUDA-Q platform, providing instructions for installation, quantum programming, and hardware connectivity. It follows security best practices by advising environment-variable-based secret management and links to official documentation.

  • Socket19d

    No alerts

  • Snyk19d

    Risk: LOW · No issues

Signed by skilld at 46293cb. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago
title
CUDA-Q Guide
version
1.1.2
author
CUDA-Q Team <cuda-quantum@nvidia.com>
Other metadata
tags
[
  "cuda-quantum",
  "quantum-computing",
  "onboarding",
  "getting-started",
  "authoring",
  "kernels",
  "nvidia"
]
tools
[
  "Read",
  "Glob",
  "Grep"
]
compatibility
Python 3.10+, C++ 20
metadata
{
  "author": "CUDA-Q Team <cuda-quantum@nvidia.com>",
  "tags": [
    "cuda-quantum",
    "quantum-computing",
    "onboarding",
    "getting-started",
    "nvidia"
  ],
  "languages": [
    "python",
    "c++"
  ],
  "domain": "quantum"
}

README badge

README badge for nvidia/skills/cudaq-guide