guppy-programs SKILL.md skillA

guppy-programs from xi-zhao/openquantum is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add xi-zhao/openquantum/guppy-programs@git:20261012.5ce3b3e

Pins git:20261012.5ce3b3e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
xi-zhao/openquantum
Path
.agents/skills/guppy-programs/SKILL.md
Versions recorded
2
Latest version
git:20261012.5ce3b3e, committed Oct 12, 2026
First version recorded
Sep 28, 2026
Size
3,205 bytes
Repository stars
71
License
MIT

用 Guppy 编译结构化量子程序,并由 Selene QuEST 仿真中途测量、复位和经典条件门;用于检查动态电路反馈与比特顺序。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Guppy 与 Selene 混合程序

<!-- BEGIN NATIVE SDK ACCESS -->
## 原生 SDK 路径

本能力同时支持 **Guppy / Selene 的原生公开 API**。用户需要 任意 Guppy 程序、控制流、编译、模拟与结果处理 时,由 Agent 在固定依赖环境中编写和运行任务代码,不限于下文便捷 Tool 的预设模型。

使用 `node scripts/sdk-access.mjs inspect guppy-programs` 定位环境,按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航:`guppylang`、`selene_sim`;导航不是 API 白名单。

下文关于模型、门集、输入与预算的限制描述便捷 Tool 的合同;原生 SDK 另受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
<!-- END NATIVE SDK ACCESS -->

调用 `guppy_local` 的 `simulate_guppy_feedback`。固定 `guppylang==1.1.1` 与 `selene-sim==0.3.2`,
均为 Apache-2.0。先显式执行 `node scripts/setup-paper-tools.mjs guppy-programs`;需要 Python 3.12,
锁中包含平台对应的原生编译与仿真组件。

1. 指定 `numQubits`、结构化 `operations`、`shots` 和 `seed`。初态为全零;支持 H/X/Y/Z/S/T、CX、
   RX/RY/RZ,以及 `MEASURE_RESET`。旋转 `angleRadians` 用弧度,适配转换为 Guppy 的半周单位。
2. `MEASURE_RESET` 在 Z 基测量、消耗当前 qubit,再分配全零 qubit;测量按出现顺序编号。
   后续门通过 `conditionMeasurement` 和 `conditionValue` 控制是否执行。默认 -1 表示无条件。
   测量自身必须无条件,保证所有运行分支拥有相同的测量记录结构。
3. 例如 H(q0) → 测量复位(q0) → 若结果为 1 则 X(q1),应该得到测量值与 q1 完全相关、q0 恒零。
   从 `counts` 同时检查 `measurementBits` 和 `finalBits`,不要只看最终直方图。
4. `measurementBits` 按测量出现顺序排列,`finalBits` 按 q0、q1、… 排列;没有中途测量时前者为空串。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add xi-zhao/openquantum/guppy-programs@sha256:7847ec78ac0f39aa

The line at the top of this page pins the label git:20261012.5ce3b3e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_a4ynbnh26rxxd6zt.svg)](https://markdownregistry.com/a/art_a4ynbnh26rxxd6zt)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 28, 2026 and Oct 12, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261012.5ce3b3e latest2026-10-12 5ce3b3e 3,205 BA view · diff
git:20260928.4386e3d2026-09-28 4386e3d 2,356 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3205 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

xi-zhao/openquantum · 71 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_a4ynbnh26rxxd6zt
GET https://markdownregistry.com/api/v1/resolve?ref=xi-zhao/openquantum/guppy-programs
GET https://markdownregistry.com/api/v1/blob/7847ec78ac0f39aa8192444cb2e633cb1536dff36d403ca5968b08f5ec2d855e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from xi-zhao/openquantum

fixture-capability SKILL.md skill
xi-zhao/openquantum · .agents/skill-contracts/test/fixtures/capabilities/fixture-capability/SKILL.md · Contract fixture used only by the OpenQuantum Skill Contract tests.
git:20260814.132b3b6 · audit B · 71 stars
alicebob-cat-circuits SKILL.md skill
xi-zhao/openquantum · .agents/skills/alicebob-cat-circuits/SKILL.md · 用 Alice & Bob 的真实本地 Qiskit provider 构建物理或逻辑猫量子位噪声电路模型,返回调度转译后的采样和明确模型参数。
git:20261012.5ce3b3e · audit A · 71 stars
aqt-workbench SKILL.md skill
xi-zhao/openquantum · .agents/skills/aqt-workbench/SKILL.md · 官方离子阱后端本地编译与仿真,以及用户鉴权后的设备查询。
git:20261012.5ce3b3e · audit A · 71 stars
arc-rydberg SKILL.md skill
xi-zhao/openquantum · .agents/skills/arc-rydberg/SKILL.md · 使用 ARC Rydberg 的原生公开 API 完成原子、能级、跃迁矩阵元、寿命、Stark 图与相互作用,支持用户自定义模型、程序与结果文件。
git:20261013.efe0949 · audit A · 71 stars
bloqade-analog SKILL.md skill
xi-zhao/openquantum · .agents/skills/bloqade-analog/SKILL.md · 用 QuEra Bloqade Analog 在本地模拟二维 Rydberg 原子阵列的全局时变脉冲,返回逐原子占据、末态振幅、位串概率和明确单位。
git:20261012.5ce3b3e · audit A · 71 stars
braket-simulation SKILL.md skill
xi-zhao/openquantum · .agents/skills/braket-simulation/SKILL.md · 使用 Amazon Braket LocalSimulator 在本地计算结构化量子电路的精确数值振幅与概率。
git:20261012.5ce3b3e · audit A · 71 stars
catalyst-compilation SKILL.md skill
xi-zhao/openquantum · .agents/skills/catalyst-compilation/SKILL.md · 使用 PennyLane Catalyst 的原生公开 API 完成qjit、混合程序、QNode、控制流、编译配置与梯度,支持用户自定义模型、程序与结果文件。
git:20261013.efe0949 · audit A · 71 stars
chromobius-decoding SKILL.md skill
xi-zhao/openquantum · .agents/skills/chromobius-decoding/SKILL.md · 使用 Chromobius 的原生公开 API 对带颜色和基标注的 Stim detector error model 解码,比较预测与实际逻辑 observable 翻转;用于色码解码、样本分析和可复核小规模实验。
git:20261026.f44a0b2 · audit A · 71 stars
classiq-synthesis SKILL.md skill
xi-zhao/openquantum · .agents/skills/classiq-synthesis/SKILL.md · 使用 Classiq 官方 SDK 构建结构化 Qmod 模型,或通过用户自行配置的凭据调用远程综合;区分模型准备、云端综合和量子执行。
git:20261012.5ce3b3e · audit A · 71 stars
clifft-sampling SKILL.md skill
xi-zhao/openquantum · .agents/skills/clifft-sampling/SKILL.md · 用固定 Clifft 对 Clifford+T 电路做带噪采样或 Stim 格式的纠错记录采样,按活跃宽度控制成本,可选最终测量密度矩阵参考。
git:20261012.5ce3b3e · audit A · 71 stars
compact-optimization SKILL.md skill
xi-zhao/openquantum · .agents/skills/compact-optimization/SKILL.md · 用固定 Compact 执行线路优化与独立等价对照,解释输入语义、独立数值对照、成本与科学边界。
git:20261012.5ce3b3e · audit A · 71 stars
cqlib-kernel SKILL.md skill
xi-zhao/openquantum · .agents/skills/cqlib-kernel/SKILL.md · 用固定 cqlib-qml 执行角度编码核与 QSVM,解释输入语义、独立数值对照、成本与科学边界。
git:20261012.5ce3b3e · audit A · 71 stars

Every file in xi-zhao/openquantum

Browse by kind, by grade A, or by owner.