Qiskit Quantum Circuit Assistant
A version-pinned guide for building, simulating, transpiling, and running quantum circuits with Qiskit 2.x and IBM Quantum Runtime.
Dev & CodingAdvanced★ 33,030⑂ 3,248AI score 9/10Last updated: Aug 9, 2026
What it does
- Enforces the modern Qiskit 2.x workflow: map the problem to a circuit → transpile once against the backend target (ISA circuit) → execute via V2 primitives (SamplerV2/EstimatorV2) with PUBs → analyze register-aware results.
- Gives a decision table for exact local sampling/estimation, high-performance or noisy Aer simulation, and real IBM QPU execution (including when to prefer QuTiP or PennyLane instead).
- Lists non-negotiable rules that keep the agent off removed or deprecated APIs: V1 primitives,
QuantumInstance,backend.configuration(),BackendProperties,qiskit.pulse. - Covers Job/Batch/Session execution modes, error mitigation via resilience levels,
observable.apply_layout(), seeds and reproducibility, plus a pre-flight checklist and credential hygiene. - Ships bundled scripts (environment check, runnable local primitives demo, read-only backend inspection) and topic-specific reference docs.
Who it's for
- Engineers and researchers migrating Qiskit 0.x/1.x code to 2.x.
- Anyone submitting jobs to real hardware on IBM Quantum Platform.
- Variational-algorithm developers who keep re-transpiling parameterized circuits per iteration.
- Educators refreshing quantum computing course material against current APIs.
Usage examples
- "Build a Bell state and sample it locally with 1024 shots" → correct StatevectorSampler code that reads the
measclassical register. - "Pick the least busy QPU and estimate the ZZ expectation value with resilience level 1" → preset pass manager, ISA circuit, and layout-applied observable.
- "Run a sweep of circuits together" → Batch-mode context manager pattern with job IDs saved before waiting on results.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/HEAD/skills/qiskit/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/qiskit folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/qiskit/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/qiskit ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal in your working directory.
- Clone the repo:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy this skill only:
cp -r scientific-agent-skills/skills/qiskit ~/.claude/skills/ - Set up Python 3.10+:
uv venv --python 3.13 && source .venv/bin/activate - Install packages:
uv pip install "qiskit[visualization]==2.5.0"(addqiskit-aerfor noisy simulation,qiskit-ibm-runtimefor IBM hardware). - For QPU access, create an IBM Quantum Platform API key and save it securely as described in
references/setup.md— never hardcode it. - Restart Claude Code and try: "Use Qiskit to build and simulate a Bell state circuit."
View source on GitHub ↗License: MIT