qctrl-workbench

qctrl-workbench is a skill for Claude Code, Codex from xi-zhao/OpenQuantum. It costs 54 tokens per session (1,009 once invoked), scanned A, original, MIT.

A builder for single-qubit control graphs and a reader for the status of existing Q-CTRL Boulder Opal or Fire Opal jobs. It can prepare a serialized graph locally and, when explicitly enabled with credentials, make one remote status query.

In plain words
What is it for?
Use it to describe piecewise-constant single-qubit Hamiltonians and to check the current status of a job that already exists in a Q-CTRL account.
Why use it?
It separates local control-sequence preparation from access to Q-CTRL services. Preparing a graph does not simulate its dynamics, submit a job, or control hardware.

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 describe piecewise-constant single-qubit Hamiltonians and to check the current status of a job that already exists in a Q-CTRL account.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xi-zhao/openquantum/qctrl-workbench
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 qctrl-workbench
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 qctrl-workbench

README.md
[![agentmods](https://agentmods.dev/badge/skills/xi-zhao/openquantum/qctrl-workbench/github.svg)](https://agentmods.dev/skills/xi-zhao/openquantum/qctrl-workbench)
Your own site
<a href="https://agentmods.dev/skills/xi-zhao/openquantum/qctrl-workbench"><img src="https://agentmods.dev/badge/skills/xi-zhao/openquantum/qctrl-workbench/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 qctrl-workbench

Your own site · 80×15
<a href="https://agentmods.dev/skills/xi-zhao/openquantum/qctrl-workbench"><img src="https://agentmods.dev/badge/skills/xi-zhao/openquantum/qctrl-workbench.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,009 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.00054 $0.01009
Opus 5.5 $0.00022 $0.00404
Sonnet 5.5 $0.00011 $0.00202
Haiku 4.5 $0.00005 $0.00101

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

Security

Grade A, and why

qctrl-workbench 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 3d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (mcp/bridge.py, mcp/contracts.mjs, mcp/server.mjs, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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/qctrl-workbench/SKILL.md · 41 lines

How it starts

The opening of the file, as written. The whole thing — 41 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Q-CTRL 控制图与作业状态

原生 SDK 路径

本能力同时支持 Boulder Opal / Fire Opal 的原生公开 API。用户需要 控制图、噪声、优化、任务与执行接口 时,由 Agent 在固定依赖环境中编写和运行任务代码,不限于下文便捷 Tool 的预设模型。

使用 node scripts/sdk-access.mjs inspect qctrl-workbench 定位环境,按完整 SDK 工作流执行。模块导航:boulderopal、fireopal;导航不是 API 白名单。

本地程序构建与外部调用分开;账户、凭据、费用、设备操作和数据外发沿用宿主及用户授权。原生 SDK 访问不自动启用服务。

原生程序导入库前,按环境定位器的 bootstrap 执行启动兼容处理:关闭导入时的 PyPI 版本查询和客户端 tracking,保留上游控制与任务 API。这不限制公开 API,也不替换数值算法。

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

qctrl_cloud 默认关闭。用户按自己的厂商许可显式执行 node scripts/setup-paper-tools.mjs qctrl-workbench, 再启用连接。固定 Boulder Opal 6.1.0、Fire Opal 12.3.0;二者使用 Q-CTRL 专有服务条款。 OpenQuantum 提供适配,不复制上游 SDK 源码,不代用户申请账号或订阅。

  • prepare_boulder_opal_control 用真实 boulderopal.Graph 构建分段常数 Hamiltonian 和终态传播子节点,返回官方格式 graphJson。
  • 输入 segments 每项为 omegaX、omegaY、detuning,单位 rad/s。durationSeconds 是总时长,所有段等长。 约定 H/hbar = (omegaX X + omegaY Y + detuning Z)/2。返回图的 unitaries 输出形状为 [1, 2, 2]。
  • 图准备不计算传播子;evaluated=false。不得把序列化成功描述为动力学仿真或优化完成。
  • get_qctrl_job_status 读取 product=boulder-opal|fire-opal 与数字字符串 jobId 对应的既有作业状态。 organizationSlug 可以指定用户已有的组织;空字符串交由 SDK 在单一有权限组织时选择。
  • 远程查询从 Harness 凭据引用读取 QCTRL_API_KEY,用户自行申请和配置。官方 SDK 执行 token 交换、组织/产品权限查询和一次状态查询。 固定端点是 https://federation-service.q-ctrl.com;没有作业提交、取消、完成轮询或硬件控制。
  • requestTimeoutSeconds 约束单次 HTTP,execution 约束整个 worker。关闭 SDK 导入时的 PyPI 升级查询、Fire Opal analytics、自动重试和重定向。
  • 错误只报告类型及排查方向,不回传厂商错误正文或派生 token。账号、密钥和商业使用权限由用户自行处理。
  • 当前 L1,scientificValidation=not_evaluated。本地成功及传输 fixture 不能证明服务已连通或作业结果科学有效。

参考:Boulder Opal、非交互 API Key、 Fire Opal 既有作业查询。

Read the full file on GitHub · 41 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 3d ago Changed · +15 lines eccca2cc031c
  2. 17d ago First seen · 26 lines · 54 tokens per session scan A a9bef068d649

Subscribe to this mod's changes

qctrl-workbench is a skill published in the GitHub repository xi-zhao/OpenQuantum (75 stars, last pushed 2d ago), licensed MIT. It adds 54 tokens to every session and 1,009 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-29.

Related

Other skills, from other repositories

immybot

Every ImmyBot endpoint typed, plus a local SQLite mirror that answers the cross-tenant questions the web UI cannot. Trigger phrases: what failed in last night's maintenance window, which tenants are still on an old version of chrome, why didn't this computer get the deployment, what changed in the fleet since…

Servosity/msp-skills · 97 tokens

unifi-network

Use when the user asks to audit a UniFi Network gateway: list adopted devices and connected clients, review firewall policies, ACL rules, VLANs and WiFi broadcasts, see what changed in site config since the last check, spot hardware that just joined the network, or check switch port and PoE headroom. Wraps the local…

Servosity/msp-skills · 187 tokens

memory-search-mcp

Long-term memory and context retrieval for AI agents. Semantic search across conversation history with care-weighted relevance.

CSOAI-ORG/memory-search-mcp · 0 tokens

fortinet

Use when the user asks to audit, inventory or back up client FortiGate firewalls, or read FortiManager or FortiGate Cloud: grades every FortiGate in a devices file for firmware, SSL-VPN exposure, admin accounts and license expiry in one read-only pass, plus HA, tunnel and certificate health, policy hygiene and config…

Servosity/msp-skills · 149 tokens

animate

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a…

stvlynn/dsh.fish · 96 tokens

gc-minimal-zine-poster-v0-3

Generate or analyze poetic paper-texture minimal zine posters with large negative space, a small editorial collage or focal element, experimental typography, and one clear color accent. Use when the user gives a theme, sentence, article, mood, object, photo, content brief, reference images, or an image folder and…

stvlynn/dsh.fish · 100 tokens