Agent skill · research science · aradotso
xq-py-quantum-vm
xq-py-quantum-vm — an agent skill for coding agents.
Why this skill is useful
Provides domain-specific knowledge on quantum circuit simulation and operations that the AI wouldn't reliably generate on its own.
What it needs
Requires git, pip installed locally. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash Clone from GitLab git clone https://gitlab.com/piqued/xqvm-py.git cd xqvm-py Install dependencies pip install -r requirements.txt Install as a package (if setup.py/pyproject.toml present) pip install -e . python from xqvm import QuantumVM, QuantumCircuit Create a quantum virtual machine vm = QuantumVM() Create a 2-qubit circuit circuit = QuantumCircuit(numqubits=2) python from xqvm import QuantumCircuit from xqvm.gates import H, X, Y, Z, CNOT, CZ, T, S circuit = QuantumCircuit(numqubits=2) Apply Hadamard gate to qubit 0 (creates superposition) circuit.apply(H, target=0) Apply Pauli-X (NOT) gate to qubit 1 circuit.apply(X, target=1) Apply CNOT (controlled-NOT): control=0, target=1 circuit.apply(CNOT, control=0, target=1) python from xqvm import QuantumVM, QuantumCircuit from xqvm.gates import H, CNOT Build Bell state circuit circuit = QuantumCircuit(numqubits=2) circuit.apply(H, target=0) circuit.apply(CNOT, control=0, target=1) Execute on the VM vm = QuantumVM() result = vm.run(circuit) print(result.statevector) # Complex amplitude vector print(result.probabilities) # Measurement probabilities per basis state python from xqvm import QuantumVM, QuantumCircuit from xqvm.gates import H circuit = QuantumCircuit(numqubits=3) circuit.apply(H, target=0) circuit.apply(H, target=1) circuit.apply(H, target=2) vm = QuantumVM() result = vm.run(circuit) Measure all qubits (collapses state, returns classical bits) bits = result.measure() print(bits) # e.g. [0, 1, 0] Measure a specific qubit bit = result.measurequbit(0) print(bit) # 0 or 1 python from xqvm import QuantumVM, QuantumCircuit from xqvm.gates import H, CNOT circuit = QuantumCircuit(numqubits=2) circuit.apply(H, target=0) circuit.apply(CNOT, control=0, target=1) vm = QuantumVM() Run 1024 shots and collect measurement histogram counts = vm.sample(circuit, shots=1024) print(counts) # e.g. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/xq-py-quantum-vm