Qiskit Quantum Circuit Assistant
Guides Claude to build, simulate, transpile, and run quantum circuits with modern Qiskit 2.x and IBM Quantum Runtime.
Dev & CodingAdvanced★ 33,030⑂ 3,248AI score 8/10Last updated: Aug 9, 2026
What it does
Pins Claude to the current Qiskit 2.5 / qiskit-ibm-runtime 0.48 / qiskit-aer 0.17 APIs instead of outdated tutorial code.
- V2 primitives (
StatevectorSampler,StatevectorEstimator,SamplerV2,EstimatorV2) driven by PUB inputs - Target-aware ISA circuits via
generate_preset_pass_managerplusobservable.apply_layout()for Estimator workloads - Clear routing between exact local simulation, noisy Aer simulation, and real IBM QPU execution
- Job / Batch / Session mode selection, resilience levels, and result-metadata recording
- Hard bans on removed APIs: V1 primitives,
QuantumInstance,backend.configuration(),qiskit.pulse - Bundled scripts for environment checks, a runnable local primitives demo, and read-only backend inspection
Who it's for
- Students and researchers whose Qiskit 0.x/1.x snippets keep breaking
- Developers running variational algorithms (VQE, QAOA) on IBM hardware
- Teams that must document reproducibility: seeds, versions, job IDs, primitive options
Examples
- "Sample a Bell state locally with 1024 shots" →
StatevectorSamplercode reading counts from themeasregister. - "Pick the least busy QPU and measure the ZZ expectation with mitigation" → pass manager builds the ISA circuit, observable layout is applied,
EstimatorV2(resilience_level=1)runs it. - "Submit a 100-point parameter sweep" → Batch-mode example that transpiles the parameterized circuit once and passes parameter arrays in PUBs.
· · · Install guide · · ·
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.
- Clone the repository:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy just this skill:
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-aer==0.17.2for noisy simulation andqiskit-ibm-runtime==0.48.0for hardware access. - For real QPUs, create an IBM Quantum Platform account and save the API key as described in
references/setup.md— never hard-code keys in notebooks or source. - Restart Claude Code and try a prompt like "Build and sample a Bell-state circuit with Qiskit".
View source on GitHub ↗License: MIT