Upstream Sources and Version Provenance

Verification Snapshot

Research completed 2026-07-23 using official IBM Quantum documentation, Qiskit repositories and releases, PyPI metadata, Context7's Qiskit indexes, and Parallel web search/extraction.

PyPI versions observed:

Distribution	Version	PyPI
Qiskit SDK	2.5.0	qiskit
Qiskit IBM Runtime	0.48.0	qiskit-ibm-runtime
Qiskit Aer	0.17.2	qiskit-aer
Qiskit Algorithms	0.4.0	qiskit-algorithms
Qiskit Nature	0.8.0	qiskit-nature
Qiskit Nature PySCF	0.4.0	qiskit-nature-pyscf
Qiskit Machine Learning	0.9.0	qiskit-machine-learning
Qiskit Optimization	0.7.0	qiskit-optimization

The Qiskit GitHub repository published 2.5.1 on 2026-07-23, shortly before this update. At verification time, PyPI metadata still reported 2.5.0, so executable examples use the available qiskit==2.5.0 pin. Recheck both sources before updating.

Canonical Qiskit SDK Sources

• IBM Quantum documentation
• Qiskit quickstart
• Install Qiskit
• Qiskit SDK API reference
• Qiskit SDK release notes
• Qiskit 2.5 release notes
• Qiskit GitHub repository
• Qiskit GitHub releases

Use quantum.cloud.ibm.com/docs for current guides. Old qiskit.org/learn, qiskit.org/ecosystem/..., and legacy documentation URLs can be stale or redirect.

Core User Guides

Circuits and quantum information

• Construct circuits
• Circuit library API
• Quantum information API
• QPY serialization API
• OpenQASM 2 API
• OpenQASM 3 API

Primitives

• Introduction to primitives
• Primitive input and output
• Exact simulation with SDK primitives
• Primitives API

Transpilation

• Introduction to transpilation
• Compare transpiler settings
• Transpiler API
• Preset pass managers API

Visualization

• Visualization API

Migration Sources

• Qiskit 2.0 migration guide
• Qiskit 1.0 feature changes
• Qiskit package-structure migration
• Migrate BackendV1 to BackendV2
• Migrate to V2 Runtime primitives
• Migrate Qiskit Pulse to fractional gates
• Migrate from IBM Quantum Platform Classic

Qiskit 2.0 removed qiskit.pulse, legacy instruction conditions, V1 reference primitive implementations, and several BackendV1-era interfaces. Runtime V1 primitive support was removed earlier. Read both SDK and Runtime migration guides because they version independently.

IBM Quantum Runtime Sources

• Qiskit IBM Runtime repository
• Runtime client release notes
• QiskitRuntimeService API
• Runtime SamplerV2 API
• Runtime EstimatorV2 API
• Set up IBM Quantum Platform
• Runtime execution modes
• Run jobs in a batch
• Run jobs in a session
• Runtime local testing mode
• Sampler options
• Estimator options
• Error mitigation and suppression

Runtime 0.48 uses ibm_quantum_platform, V2 primitives, mode=..., implementation-specific options, and explicit ISA circuits.

Simulation

• Qiskit Aer documentation
• Aer simulator API
• Aer primitives API

The Aer documentation landing page can lag the newest patch label. Use PyPI and GitHub releases for the install pin, then use versioned API behavior from the installed package.

Application-Package Documentation

• Qiskit Algorithms 0.4
• Qiskit Nature 0.8
• Qiskit Nature getting started
• Qiskit Machine Learning 0.9
• Qiskit Machine Learning migration guide
• Qiskit Optimization 0.7
• Qiskit Optimization migration guides

Application packages release independently. Check their requirements before changing the core Qiskit pin.

Addon Documentation

• Qiskit addon: circuit cutting
• Qiskit addon: sample-based quantum diagonalization
• Qiskit addon: operator backpropagation
• Qiskit addon: multi-product formulas
• Qiskit addon: AQC-Tensor
• IBM guide to Qiskit addons

Addon versions observed on PyPI:

Distribution	Version
qiskit-addon-cutting	0.10.0
qiskit-addon-sqd	0.12.1
qiskit-addon-obp	0.3.0
qiskit-addon-mpf	0.3.0
qiskit-addon-aqc-tensor	0.3.1

Research Queries Used

The refresh used focused Parallel searches for:

• current Qiskit, Runtime, Aer, and application-package versions,
• Qiskit 2.x removals, deprecations, and migration guides,
• current Runtime authentication, execution modes, and option models,
• current circuit, primitive, transpilation, simulation, and serialization guides,
• current ecosystem and addon package APIs.

Canonical pages were then extracted directly. Specific API patterns were cross-checked with Context7 and executed in isolated uv environments pinned to the versions above.

How to Refresh This Skill

1. Query PyPI JSON metadata for every pinned distribution.
2. Compare PyPI with GitHub releases and official release notes.
3. Read Qiskit major/minor migration and deprecation sections.
4. Read Runtime release notes independently.
5. Recheck valid channel names, account setup, plan restrictions, and option compatibility.
6. Run all bundled scripts in an isolated environment.
7. Execute the core, Algorithms, Optimization, Machine Learning, and visualization snippets.
8. Update the verification date and version tables.
9. Increment metadata.version in SKILL.md.
10. Run uv run skills-ref validate skills/qiskit and the local security scan.