OpenQuantum: Skill for Codex

.agents/skills/qiskit-circuit-workbench/SKILL.md

qiskit-circuit-workbench is a skill for Codex from xi-zhao/OpenQuantum. It costs 117 tokens per session (923 once invoked), scanned A, original, MIT.

A local workbench for reading, converting, analysing, and translating OpenQASM 3 and QPY quantum circuits. QPY is Qiskit's binary circuit format, while OpenQASM 3 is a text format.

In plain words
What is it for?
Use it for circuit reviews, QASM/QPY conversion, gate and depth analysis, Qiskit optimisation comparisons, and checking Qiskit documentation or error codes.
Why use it?
It gathers circuit facts such as gate count and depth and makes format conversion or optimisation comparisons repeatable without automatically sending work to quantum hardware.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: installed under .agents/ (shared by several agents).

This is xi-zhao/OpenQuantum's own configuration. It tells Codex how to work on OpenQuantum itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything OpenQuantum configures →

Reuse

Borrowing it

Nothing to install: this file belongs to xi-zhao/OpenQuantum. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/xi-zhao/OpenQuantum/main/.agents/skills/qiskit-circuit-workbench/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/xi-zhao/OpenQuantum

Made for: 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 qiskit-circuit-workbench

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/xi-zhao/openquantum/qiskit-circuit-workbench"><img src="https://agentmods.dev/badge/skills/xi-zhao/openquantum/qiskit-circuit-workbench.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 117 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 923 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. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.00117 $0.00923
Opus 5 $0.00059 $0.00462
Sonnet 5 $0.00023 $0.00185
Haiku 4.5 $0.00012 $0.00092

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

Security

Grade A, and why

qiskit-circuit-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 10d 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/qiskit-circuit-workbench/SKILL.md · 57 lines

What it actually says

Qiskit Circuit Workbench

工作边界

把这个 Skill 当作量子电路工程工作台,而不是通用量子求解器。默认只使用无凭据的 qiskitqiskit_docs MCP Server 暴露并经 Harness MCP Client 注册的 Tool:

  • 读取与导出 OpenQASM 3;
  • 在 QASM 3 与 QPY 之间转换;
  • 分析电路门数、深度、寄存器和操作;
  • 比较 Qiskit 转译优化等级;
  • 查证当前 Qiskit 文档、API 和错误码。

不要因为电路能加载、转译或执行就宣称算法正确、物理模型正确或科学验收通过。真实 IBM Runtime、 IBM Transpiler 和社区硬件 MCP Server 都是独立的可选连接器,只有用户明确要求、设置中心连接配置已启用且费用与数据 外发边界已说明时才考虑使用。

工作流

  1. 先确认输入是 OpenQASM 3、QPY,还是自然语言描述的电路意图。
  2. 若只有自然语言意图,先写出最小 OpenQASM 3 草案,并明确量子位、经典位、测量和参数约定。
  3. load_circuit_from_qasm_tool 解析 QASM;解析失败时保留原始错误,不猜测电路已有效。
  4. analyze_circuit_tool 取得基线指标。至少记录量子位数、经典位数、深度、门计数和测量。
  5. 只有用户要求优化或目标后端约束时才转译:
    • 比较优化等级时调用 compare_optimization_levels_tool
    • 已有明确目标参数时调用 transpile_circuit_tool
    • 比较时保持同一输入和同一目标约束,不混用不可比结果。
  6. 需要 QPY/QASM 互换时使用 convert_qpy_to_qasm3_toolconvert_qasm3_to_qpy_tool;需要最终文本时使用 export_circuit_to_qasm_tool
  7. 遇到 API、版本、迁移或错误码不确定时,依次使用 Qiskit Docs MCP-exposed Tool: search_docs_toolget_page_toollookup_error_code_tool,以取回页面为准。
  8. 输出“输入事实 → 工具结果 → 变更 → 未验证项”,不要把模型推断混进工具事实。

审查规则

  • 转译前后复核量子位、经典位、测量寄存器与参数是否仍满足用户意图。
  • 门数或深度下降不自动代表线路更优;同时报告二比特门、额外 SWAP、目标门集和耦合约束。
  • 未指定后端时只做抽象或本地转译,不虚构某台 QPU 的拓扑、校准或可用性。
  • 不把 QASM/QPY 内容交给 Python pickle 或其他不安全反序列化路径。
  • Harness MCP Client 连接不可用或对应 Tool 不存在时,说明缺少实测证据,只能给出待验证草案;不得编造工具指标。

输出格式

保持简洁并包含:

  1. 电路目标与输入格式;
  2. 基线指标;
  3. 采取的转换或转译;
  4. 前后指标与语义检查;
  5. 仍需用户或真实后端确认的限制;
  6. 若查了文档,附直接页面来源。
Files

What ships with it

1 file 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. 10d ago First seen · 57 lines · 117 tokens per session scan A ec9dbc295a8b

Subscribe to this mod's changes

qiskit-circuit-workbench is a skill published in the GitHub repository xi-zhao/OpenQuantum (49 stars, last pushed 2d ago), licensed MIT. It adds 117 tokens to every session and 923 once invoked, about $0.0006 per session on Opus 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-08-30.

Related

Other skills, from other repositories

academic-research

Search academic papers, scholarly articles, and research publications through SandBase. Use when asked for literature review, academic citations, scholarly research, paper discovery, or scientific evidence gathering.

sandbaseai/sandbase-skills · 39 tokens

academic-trend-research

Research emerging academic trends by combining scholarly databases, web sources, and news to identify rising research areas, breakthrough papers, and shifting scientific consensus. Ideal for R&D teams tracking frontier science.

sandbaseai/sandbase-skills · 43 tokens

alexandria

Reach for this when a research question needs cited sources across academic papers, public domain books, legal records, government archives, security advisories, news, or developer documentation. Alexandria is an MCP server backed by 152 public digital libraries; use it whenever an answer should point at real…

The-40-Thieves/alexandria-mcp · 71 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

ml-experiment-review

Use this skill when reviewing an ML experiment, benchmark, ablation, or training run.

NeoXider/neoxider-mcp-hub · 0 tokens

noodle-biomedical-literature-discovery

Find, inspect, compare, and traverse public biomedical research literature. Use for PubMed or scholarly paper search, publication details, PMID/DOI/PMCID lookup, related papers, citation paths, semantic literature neighborhoods, corpus coverage, or questions asking what research exists about a gene, variant…

helena-bioinformatics/noodle-mcp · 105 tokens