quantum-vqe

quantum-vqe is a skill for Claude Code, Codex from xi-zhao/OpenQuantum. It costs 53 tokens per session (760 once invoked), scanned A, original, MIT.

A runnable guide to the variational quantum eigensolver (VQE), a quantum algorithm that estimates the lowest energy of a mathematical system by adjusting a parameterized circuit. It uses Pauli Hamiltonians, a specified circuit form, and SciPy optimization.

In plain words
What is it for?
Use it to explain VQE, run it on supplied data, or generate and modify its Python code. It reports energies and optimization records and notes issues such as non-convergence or insufficient samples.
Why use it?
It provides a local, reviewable way to explain, run, or modify this calculation without treating example inputs as the user's data. It preserves inputs and results so numerical claims can be checked.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it to explain VQE, run it on supplied data, or generate and modify its Python code. It reports energies and optimization records and notes issues such as non-convergence or insufficient samples.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xi-zhao/openquantum/quantum-vqe
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add xi-zhao/OpenQuantum --skill quantum-vqe
Clone the repo
git clone --depth 1 https://github.com/xi-zhao/OpenQuantum

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for quantum-vqe

README.md
[![agentmods](https://agentmods.dev/badge/skills/xi-zhao/openquantum/quantum-vqe/github.svg)](https://agentmods.dev/skills/xi-zhao/openquantum/quantum-vqe)
Your own site
<a href="https://agentmods.dev/skills/xi-zhao/openquantum/quantum-vqe"><img src="https://agentmods.dev/badge/skills/xi-zhao/openquantum/quantum-vqe/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for quantum-vqe

Your own site · 80×15
<a href="https://agentmods.dev/skills/xi-zhao/openquantum/quantum-vqe"><img src="https://agentmods.dev/badge/skills/xi-zhao/openquantum/quantum-vqe.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 53 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 760 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00053 $0.00760
Opus 5.5 $0.00021 $0.00304
Sonnet 5.5 $0.00011 $0.00152
Haiku 4.5 $0.00005 $0.00076

Measured 13d ago against content hash f853649c2ecd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

quantum-vqe scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/quantum-vqe/SKILL.md · 39 lines

What it actually says

vqe

本地开源适配。上游指南 ID:algorithms/quantum-machine-learning/vqe。

适用方法

实 Pauli Hamiltonian、RY/RZ/CX ansatz 和 SciPy 优化;能量、优化记录及保留的参数可复查。

使用步骤

  1. 先识别用户是在询问原理、要求运行,还是要求生成/修改代码;仅解释时不自动开始计算。
  2. 阅读共同运行说明和本地实现。可通过已有 quantum_practices Tool 的 get 动作、id=algorithms/quantum-machine-learning/vqe 读取完整理论、原始参数和推导;其中的外部安装命令及 UnitaryLab 后端要求不适用于本地执行。
  3. 根据任务准备实际输入,核对下面的参数签名。省略输入只会运行教学示例,不能把它冒充用户数据的结果。需要示例以外的 ansatz、oracle、边界条件或输出时,基于开源 SDK 生成可审查的任务代码。
  4. 使用 Harness 已有的 bash(Windows 为 pwsh)Tool 执行。在 OpenQuantum 仓库根目录,先检查示例 Python 环境;缺少依赖时显式执行 npm run capability:algorithms:setup -- --minimal。执行和安装均受现有 Harness 权限、审批、超时及 Job 管理约束。Skill 不启动服务。
  5. 读取实际结果和错误;保留输入、依赖版本、种子、近似参数与输出。优化未收敛、后选择概率低、码距未计算或样本不足都必须按实际字段报告。通过经典对照或收敛检查支持数值结论;最终科学验收仍为 not_evaluated。

参数:

vqe(terms=None, layers=2, maxiter=150, seed=7)

最小可运行示例(macOS/Linux;Windows Python 路径见共同说明):

examples/quantum-algorithms/.venv/bin/python examples/quantum-algorithms/run.py --algorithm vqe

用户参数写入 JSON 文件,追加 --input <path>;需要保留报告时追加 --output <path>。输入规模由用户选择,不能把示例默认值当成算法上限。

来源与边界

上游 MIT 指南:algorithms/quantum-machine-learning/vqe。原文作为参考保存在固定检索库,本文件将执行路线改为开源 SDK。来源摘要和算法模块对应关系见coverage.json,许可证与改动说明见NOTICE。

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 13d ago First seen · 39 lines · 53 tokens per session scan A f853649c2ecd

Subscribe to this mod's changes

quantum-vqe is a skill published in the GitHub repository xi-zhao/OpenQuantum (74 stars, last pushed 9d ago), licensed MIT. It adds 53 tokens to every session and 760 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-25.