# cudaq-guide

Проводит по установке CUDA-Q, выбору целей симуляции, доступу к QPU и написанию кернелов на Python. Пригодится, когда нужно быстро разобраться с квантовым стеком NVIDIA.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2500 установок · ★ 3735
- Автор: CUDA-Q Team
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NVIDIA/skills/tree/HEAD/skills/cudaq-guide/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/cudaq-guide

## Что делает

Скилл разбит на маршруты по аргументу. `/cudaq-guide install` ведёт через установку и проверку, `test-program` собирает и запускает кернел состояния Белла, `gpu-sim` помогает выбрать GPU, multi-GPU, tensor-network или CPU-цель. Отдельные ветки — `qpu` для подключения к железу и `parallelize` для `mgpu`, `mqpu`, асинхронной отправки и распределённого observe. Без аргумента скилл печатает меню и спрашивает, что нужно.

Внутри два справочных файла: `references/onboarding.md` про установку, цели, провайдеров QPU и режимы параллелизации, `references/authoring.md` про API исполнения, ограничения языка кернелов и типичные ошибки компилятора. Скилл читает локальную документацию, когда ответ зависит от версии CUDA-Q или поведения бэкенда. Инструменты — только чтение: `Read`, `Glob`, `Grep`.

Для Python-сценариев нужен Python 3.10+, для GPU-целей на Linux — CUDA Toolkit и карта NVIDIA, для C++ — Linux или WSL и C++20. Доступ к QPU требует учётных данных провайдера. Ветка `author` описывает decorator-mode API CUDA-Q 0.14 и 0.15, поэтому на других версиях поведение может отличаться — сверяйте с `cudaq.__version__`. Вопросы переноса с Qiskit скилл не разбирает, для этого есть `cudaq-importing`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill cudaq-guide -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/cudaq-guide/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/cudaq-guide/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill cudaq-guide -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/cudaq-guide/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill cudaq-guide -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/cudaq-guide/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills cudaq-guide
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/cudaq-guide/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill cudaq-guide -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/cudaq-guide
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/cudaq-guide/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill cudaq-guide -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NVIDIA/skills/tree/HEAD/skills/cudaq-guide/SKILL.md

## Когда брать
- поставить CUDA-Q и проверить, что импорт работает
- написать и запустить кернел состояния Белла
- выбрать между GPU, multi-GPU и CPU-симуляцией
- подключиться к QPU с учётными данными провайдера
- разобраться, почему кернел не компилируется

## Примеры запросов агенту
- /cudaq-guide install
- /cudaq-guide author — помоги написать кернел на @cudaq.kernel
- /cudaq-guide gpu-sim — какую цель выбрать для симуляции на GPU?

## Похожие
- [pennylane](https://affpapa.org/nevibecode/skills/pennylane.md) — скилл · 1900 установок
- [narrative-nonfiction](https://affpapa.org/nevibecode/skills/narrative-nonfiction.md) — скилл · 564 установки
- [hermes-agent-skill-authoring](https://affpapa.org/nevibecode/skills/hermes-agent-skill-authoring.md) — скилл · 518 установок
- [rayfin](https://affpapa.org/nevibecode/plugins/rayfin.md) — плагин · ★ 648
- [start-learning](https://affpapa.org/nevibecode/skills/start-learning.md) — скилл · 4600 установок
- [find-your-level](https://affpapa.org/nevibecode/skills/find-your-level.md) — скилл · 4500 установок

Из того же набора: [nvidia/skills](https://affpapa.org/nevibecode/by/nvidia/skills.md) — 178 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md